Search Live

/content_analysis_search_live

‌ This endpoint will provide you with detailed citation data available for the target keyword.

Finished calls, last 7 days: 0

Cancellations excluded. Execution times cover successful calls.

;;;;----=====++++++++=====----;;;::::····........                   .............···········............                             ......····:::::;;;;--------------;;;;;:::::······..................
;;;----===++++++++++++++====---;;;;:::·····.........             .................·····..............                                 ......····::::;;;;;--------------;;;;;:::::·······................
;;;---===++++++*****++++++===----;;;::::·····...................................·····.............                                     ......····::::;;;;;-------------;;;;;;::::::········.............
;;;---===++++*********+++++===---;;;;::::·····.............................···········...........                                       ......····::::;;;;;------------;;;;;;:::::::····················
;;;---===++++**********++++====---;;;;::::·······....................··················.........                                         ......····::::;;;;;;;------;;;;;;;;;:::::::····················
:;;;---===+++++*******+++++====----;;;:::::··········........···························........                                          ......····:::::;;;;;;;;;;;;;;;;;;:::::::::·················:::
::;;---====++++++++++++++++====---;;;;;:::::·····························::::::··········.......                                           ......·····::::::;;;;;;;;;;;;::::::::::················::::::
::;;;----====++++++++++++=====----;;;;:::::::····················:::::::::::::::::::······......                                            ......······:::::::::::::::::::::::··················:::::::
:::;;;;----=================----;;;;;;:::::::···············::::::::::::::::::::::::::·····......                                            ......·······::::::::::::::::·······················::::::;
·::::;;;-----===========------;;;;;;::::::::·············::::::::::;;;;;;;;;;;;;;;::::::·····.....                                           .......·············································::::::;
··::::;;;;;----------------;;;;;;::::::::···············:::::::::;;;;;;;;;;;;;;;;;;;;::::·····.....                                           ........························...........·········:::::;
···:::::;;;;;;;-----;;;;;;;;;::::::::···················:::::::;;;;;;;;---------;;;;;;::::·····.....                                          .........···············.......................······::::;
····::::::;;;;;;;;;;;;;;::::::::························:::::::;;;;;;--------------;;;;;::::····.....                                        .............·····................................·····::::
·····:::::::::::::::::::::::··········..........·········::::::;;;;;;---------------;;;;;:::·····.....                                     .....................................................·····:::
······:::::::::::::::::·········....................·······:::::;;;;;----------------;;;;::::····......                                  ..................................               ........·····:
······::::::::::::··········..........................······:::::;;;;;---------------;;;;;::::····......                              ..............·····...............                    ........····
······::::::::··········............          ..........······::::;;;;;--------------;;;;;::::·····.......                        ............·············............                       .......···
·····:::::::··········.........                   ........·····:::::;;;;;;---------;;;;;;:::::·····........                   ...........····················.........                          ......··
·:::::::::::········........                         .......·····:::::;;;;;;;;;;;;;;;;;;::::::·····...........          ............···········:::::··········.........                          .......
::::::::::::·······........                            .......·····::::::;;;;;;;;;;;;;::::::·······.............................········:::::::::::::::::·······.......                           ......
:::::::::::::······.......                               .......······::::::::::::::::::::········...........................·······:::::::;;;;;;;;;;:::::::·····.......                           .....
;;;;;;;;::::::·····......                                  .......·······::::::::::::::·········..........................······::::::;;;;;;;;;;;;;;;;;;;:::::·····......                          .....
---;;;;;;;;::::·····.....                                   ........·························...........................······:::::;;;;;--------------;;;;;:::::····.......                        .....
--------;;;;::::····......                                    .........·················...............................······::::;;;;------=========-----;;;;::::·····.......                      .....
=====-----;;;;:::····.....                                     ....................................          ..........·····::::;;;;----===============----;;;;::::····........                  .......
+=======----;;;:::····.....                                      ............................                  ........····::::;;;----=====++++++++++====----;;;::::·····.........            ..........
++++++====---;;;:::····.....                                      .....................                         .......····::::;;;---====++++++++++++++====---;;;;::::·····.............................
**++++++===---;;;:::···......                                     ................                                ......····:::;;;---===+++++++***++++++====---;;;;::::······.........................··
*****++++===---;;;:::···......                                    .............                                    .....····:::;;;---====+++++*****++++++====---;;;;::::········.................·······
******++++===--;;;:::····......                                 ............                                        .....····:::;;;---===+++++++**+++++++====----;;;;:::::······························
******++++===---;;;:::····......                            ................                                         .....···::::;;----===++++++++++++++=====----;;;;::::::························:::::
******++++===---;;;:::·····.......                     ......................                                         .....···:::;;;----=====+++++++++======----;;;;;:::::::·················:::::::::::
****+++++===----;;;::::····..........            .............................                                         ....····:::;;;;----================-----;;;;;:::::::::···········::::::::::::;;;;
+++++++====----;;;::::······...................................................                                        .....····::::;;;------=========-------;;;;;;:::::::::········:::::::::::;;;;;;;;;
+++=======----;;;:::::······...........................················.........                                        .....····::::;;;;;---------------;;;;;;;:::::::::··········::::::::::;;;;;;;;;--
======------;;;;:::::······.......................························.......                                       .....·····:::::;;;;;;;;;-;;;;;;;;;;;::::::::················::::::::;;;;;;;-----
--------;;;;;;:::::······......................···········::::::::::········.......                                     ......·····::::::;;;;;;;;;;;;;;::::::::······················:::::::;;;;;-------
;;;;;;;;;;::::::·······......................········:::::::::::::::::::······......                                    ......······::::::::::::::::::::::····························::::::;;;;;-------
;;;;;:::::::········........................·······:::::::::;;;;;;;:::::::······......                                 .......·······::::::::::::::::···········................········:::::;;;;;------
::::::::········............................······:::::::;;;;;;;;;;;;;;:::::·····.......                              .......·········:::::::::::··········........................······:::::;;;;------
::·········............           ..........······:::::;;;;;;;;;;;;;;;;;;:::::·····.......                          ........··········::::::···········..............    ............······::::;;;;;----
·······..........                    ........·····:::::;;;;;;;------;;;;;;;:::::·····.......                    ..........··········::::::··········...........                ........·····:::::;;;;;--
···..........                          .......····:::::;;;;;;---------;;;;;;:::::·····..........           ............·········::::::::::·········.........                      .......·····:::::;;;;;
..........                              ......·····::::;;;;;;----------;;;;;;:::::······...........................········::::::::::::::::·······........                          .......·····::::::;;
.......                                   ......····::::;;;;;;;-------;;;;;;;::::::·······....................·········:::::::::::::::::::::······.......                             .......·····::::::
......                                     ......····:::::;;;;;;;;;;;;;;;;;;;:::::::·········............·········::::::::;;;;;;;;;;;;;::::::·····......                                .......······:::
.....                                       ......····::::::;;;;;;;;;;;;;;;;::::::::··························:::::::;;;;;;;;;;;;;;;;;;;;:::::····......                                  .......·······
....                                          .....·····::::::;;;;;;;;;;;;:::::::::·······················:::::::;;;;;;---------------;;;;;::::····......                                  .........····

Use it with your agent

Set up https://www.agentrouter.to/SKILL.md, then use DataForSEO’s /content_analysis_search_live endpoint through AgentRouter.

Inputs

keywordRequired: target keyword required field UTF-8 encoding the keywords will be converted to a lowercase format; Note : to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; example: `"keyword": "\"tesla palo alto\""` learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
keyword_fieldsOptional: target keyword fields and target keywords optional field use this parameter to filter the dataset by keywords that certain fields should contain; fields you can specify: title , main_title , previous_title , snippet you can indicate several fields; Note : to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; example: `"keyword_fields": { "snippet": "\"logitech mouse\"", "main_title": "sale" }"`
page_typeOptional: target page types optional field use this parameter to filter the dataset by page types possible values: "ecommerce" , "news" , "blogs" , "message-boards" , "organization"
search_modeOptional: results grouping type optional field possible grouping types: as_is - returns all citations for the target keyword one_per_domain - returns one citation of the keyword per domain default value: as_is
limitRequired: the maximum number of returned citations optional field default value: 100 maximum value: 1000
filtersOptional: array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and , or between the conditions the following operators are supported: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , like , not_like , match , not_match you can use the % operator with like and not_like to match any string of zero or more characters example: ["country","=", "US"] [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]] [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or", ["content_info.text_category","has",10994]]] for more information about filters, please refer to Content Analysis API - Filters
order_byOptional: results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc - results will be sorted in the ascending order desc - results will be sorted in the descending order you should use a comma to set up a sorting type example: ["content_info.sentiment_connotations.anger,desc"] default rule: ["content_info.sentiment_connotations.anger,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
offsetOptional: offset in the results array of returned citations optional field default value: 0 if you specify the 10 value, the first ten citations in the results array will be omitted and the data will be provided for the successive citations Note: we recommend using this parameter only when retrieving up to 10,000 results for retrieving over 10,000 results, use the offset_token instead.
offset_tokenOptional: offset token for subsequent requests optional field provided in the identical field of the response to each request; use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request; by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task; offset_token values are unique for each subsequent task Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task learn more about this parameter on our Help Center
rank_scaleOptional: defines the scale used for calculating and displaying the domain_rank , and url_rank values optional field you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: one_hundred — rank values are displayed on a 0–100 scale one_thousand — rank values are displayed on a 0–1000 scale default value: one_thousand learn more about how this parameter works in this Help Center article

Example input

{
  "keyword_fields": {
    "snippet": "logitech"
  },
  "keyword": "logitech",
  "page_type": [
    "ecommerce",
    "news",
    "blogs",
    "message-boards",
    "organization"
  ],
  "search_mode": "as_is",
  "filters": [
    "main_domain",
    "=",
    "reviewfinder.ca"
  ],
  "order_by": [
    "content_info.sentiment_connotations.anger,desc"
  ],
  "limit": 10
}

Output

Native task result envelope; includes items, aggregates and pagination where supported.