DataForSEO

What you can do

Available commands: 37 (36 read, 1 write). Enable only the commands your application needs.

Run List Labs locations and languages with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run List AI mention locations and languages with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run List Google search languages with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run List Google Ads locations with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "resource": "cn"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run List Google Ads languages with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run List Google search locations with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "resource": "cn"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run Keyword suggestions with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keyword": "workflow",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Related keywords with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keyword": "workflow",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Keyword ideas with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keywords": [
        "workflow"
      ],
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Keyword overview with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keywords": [
        "workflow"
      ]
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Site ranking keywords with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "target": "example.com",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Site related pages with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "target": "example.com",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Search competitor sites with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keywords": [
        "workflow"
      ],
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Google Ads keyword suggestions with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keywords": [
        "workflow"
      ]
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Look up keyword search volume with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keywords": [
        "workflow"
      ]
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Organic search results with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keyword": "coffee",
      "depth": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Map search results with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keyword": "coffee",
      "depth": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Local search results with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "keyword": "coffee",
      "depth": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Read domain ranking overview with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "location_code": 2840,
      "language_code": "en",
      "target": "example.com"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Backlinks overview with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": "example.com"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Read backlinks with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": "example.com",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Referring domains with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": "example.com",
      "limit": 5
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Domain pages overview with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": "example.com"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Historical backlink trend with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": "example.com"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run List LLM response models with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "engine": "chat_gpt"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run Read a queued Google organic SERP task with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "taskId": "07251558-1535-0066-0000-04e2d2d5f0f4"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Run Queue a Google organic SERP task with DataForSEO. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "keyword": "workflow orchestration",
      "location_code": 2840,
      "language_code": "en",
      "depth": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Search business listings with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "categories": [
        "pizza_restaurant"
      ],
      "location_coordinate": "53.476225,-2.243572,10",
      "limit": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Read Google business questions and answers with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "keyword": "The Last Bookstore",
      "location_code": 2840,
      "language_code": "en"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Analyse one page on demand with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "url": "https://www.tooluse.net/"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Run Run a Lighthouse audit with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "url": "https://www.tooluse.net/",
      "for_mobile": false
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Run Validate a page's structured data with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "id": "02241700-1535-0216-0000-034137259bc1",
      "url": "https://www.tooluse.net/"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 90 seconds.

Run Ask an LLM and record its answer with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "user_prompt": "Which platforms orchestrate agent workflows?",
      "model_name": "gpt-4o"
    }
  ],
  "engine": "chat_gpt"
}

At most 1 provider requests per invocation; timeout: 180 seconds.

Run Search LLM mentions with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": [
        {
          "keyword": "agentmq",
          "search_filter": "include"
        }
      ],
      "location_code": 2840,
      "language_code": "en",
      "platform": "chat_gpt",
      "limit": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Run Summarise LLM mentions for one target set with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": [
        {
          "keyword": "agentmq",
          "search_filter": "include"
        }
      ],
      "location_code": 2840,
      "language_code": "en",
      "platform": "chat_gpt",
      "limit": 10
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Run Rank the pages LLM answers cite with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "target": [
        {
          "keyword": "agentmq",
          "search_filter": "include"
        }
      ],
      "location_code": 2840,
      "language_code": "en",
      "platform": "chat_gpt",
      "limit": 10,
      "links_scope": "sources"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Run Compare LLM mentions across target sets with DataForSEO. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "tasks": [
    {
      "targets": [
        {
          "key": "agentmq",
          "target": [
            {
              "domain": "tooluse.net"
            }
          ]
        },
        {
          "key": "competitor",
          "target": [
            {
              "domain": "example.com"
            }
          ]
        }
      ],
      "location_code": 2840,
      "language_code": "en",
      "platform": "google"
    }
  ]
}

At most 1 provider requests per invocation; timeout: 120 seconds.