DataForSEO Content Analysis Search

From 28.8 credits/call
ae_dataforseo_content_analysis_search

Find detailed citations and mentions of a keyword across news, blogs, and other web content using DataForSEO. Filter results by page type and sort by relevance or sentiment.

Search
From 28.8 credits/call

Pricing

From 28.8 credits/call
ConditionCharge
Base processing fee per call28.8 credits
Per record0.1 credits

Charges depend on the actual returned results.

The starting price is the base query fee; returned records add the listed charges.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].limitinteger | nullNoNo parameter description.—
tasks[].offsetinteger | nullNoNo parameter description.—
tasks[].filtersarray | nullNoNo parameter description.—
tasks[].keywordstringNo<em>target keyword</em><br><strong>required field</strong><br>UTF-8 encoding<br>the keywords will be converted to a lowercase format;<br><strong>Note</strong>: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes; <br>example: <br>`"keyword": "\"tesla palo alto\""`<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a>—
tasks[].order_byarray | nullNoNo parameter description.—
tasks[].page_typearray | nullNoNo parameter description.—
tasks[].rank_scalestring | nullNoNo parameter description.—
tasks[].search_modestring | nullNoNo parameter description.—
tasks[].offset_tokenstring | nullNoNo parameter description.—
tasks[].keyword_fieldsobject | nullNoNo parameter description.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_content_analysis_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "keyword": "OpenAI",
        "limit": 1
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.024036,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.024036,
      "data": {
        "api": "content_analysis",
        "function": "search",
        "keyword": "OpenAI",
        "limit": 1
      },
      "id": "10261118-2802-0463-0000-e2435bee0c00",
      "path": [
        "v3"
      ],
      "result": [
        {
          "items": [
            {}
          ],
          "items_count": 1,
          "offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxLCJSYXdSZXF1ZXN0Ijp7ImtleXdvcmQiOiJPcGVuQUkiLCJsaW1pdCI6MSwicmFua19zY2FsZSI6Im9uZV90aG91c2FuZCIsImFpZCI6MjgwMjIzLCJ0YXNrX2lkIjoiMTAyNjExMTgtMjgwMi0wNDYzLTAwMDAtZTI0MzViZWUwYzAwIn0sIlNlYXJjaEFmdGVyRGF0YSI6eyJWZXJzaW9uIjoxLCJTZWFyY2hB",
          "total_count": 18417208
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.