--- title: "DataForSEO" description: "Keyword, search result, domain ranking and backlink data. One task is submitted per request, with bounded keyword and result counts." --- > Documentation Index > Fetch the complete documentation index at: https://help.tooluse.net/llms.txt > Use this file to discover all available pages before exploring further. # DataForSEO

Keyword, search result, domain ranking and backlink data. One task is submitted per request, with bounded keyword and result counts.

What you can do (37)

What you can do

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

Command Effect
List Labs locations and languages — dataforseo.dataforseo_labs.locations_and_languages Read
List AI mention locations and languages — dataforseo.ai_optimization.llm_mentions.locations_and_languages Read
List Google search languages — dataforseo.serp.google.languages Read
List Google Ads locations — dataforseo.keywords_data.google_ads.locations Read
List Google Ads languages — dataforseo.keywords_data.google_ads.languages Read
List Google search locations — dataforseo.serp.google.locations Read
Keyword suggestions — dataforseo.dataforseo_labs.google.keyword_suggestions.live Read
Related keywords — dataforseo.dataforseo_labs.google.related_keywords.live Read
Keyword ideas — dataforseo.dataforseo_labs.google.keyword_ideas.live Read
Keyword overview — dataforseo.dataforseo_labs.google.keyword_overview.live Read
Site ranking keywords — dataforseo.dataforseo_labs.google.ranked_keywords.live Read
Site related pages — dataforseo.dataforseo_labs.google.relevant_pages.live Read
Search competitor sites — dataforseo.dataforseo_labs.google.serp_competitors.live Read
Google Ads keyword suggestions — dataforseo.keywords_data.google_ads.keywords_for_keywords.live Read
Look up keyword search volume — dataforseo.keywords_data.google_ads.search_volume.live Read
Organic search results — dataforseo.serp.google.organic.live.advanced Read
Map search results — dataforseo.serp.google.maps.live.advanced Read
Local search results — dataforseo.serp.google.local_finder.live.advanced Read
Read domain ranking overview — dataforseo.dataforseo_labs.google.domain_rank_overview.live Read
Backlinks overview — dataforseo.backlinks.summary.live Read
Read backlinks — dataforseo.backlinks.backlinks.live Read
Referring domains — dataforseo.backlinks.referring_domains.live Read
Domain pages overview — dataforseo.backlinks.domain_pages_summary.live Read
Historical backlink trend — dataforseo.backlinks.history.live Read
List LLM response models — dataforseo.ai-optimization.models Read
Read a queued Google organic SERP task — dataforseo.serp.google.organic.task_get.advanced Read
Queue a Google organic SERP task — dataforseo.serp.google.organic.task_post Write
Search business listings — dataforseo.business_data.business_listings.search.live Read
Read Google business questions and answers — dataforseo.business_data.google.questions_and_answers.live Read
Analyse one page on demand — dataforseo.on_page.instant_pages Read
Run a Lighthouse audit — dataforseo.on_page.lighthouse.live.json Read
Validate a page's structured data — dataforseo.on_page.microdata Read
Ask an LLM and record its answer — dataforseo.ai-optimization.llm-response Read
Search LLM mentions — dataforseo.ai_optimization.llm_mentions.search_mentions.live Read
Summarise LLM mentions for one target set — dataforseo.ai_optimization.llm_mentions.target_metrics.live Read
Rank the pages LLM answers cite — dataforseo.ai_optimization.llm_mentions.top_mentioned_pages.live Read
Compare LLM mentions across target sets — dataforseo.ai_optimization.llm_mentions.multi_target_metrics.live Read

Connect and use

Connect and use

Open the integration's connection form to check the available credential source. The source has not been resolved for this documentation export. The instructions below apply when using your own provider account.

Get your provider credentials

Follow these steps for DataForSEO, then enter the issued values in the connection form below.

  1. In your DataForSEO dashboard, open API Access and copy the API login and password. Enter this API password rather than your account sign-in password.

Official credential setup

Where to enter credentials

In the integration page, sign in, choose your workspace and open Connect. If a Credentials choice is shown, select Use my credentials. Fill the following connection fields and save. Provider credentials belong in this form, never in an MCP configuration or tool input.

Connection field Requirement
API Login Required
API Password Required

Open API keys and create a Tooluse.net key for the enabled commands.

Set TOOLUSE_API_KEY in your client and use the shared MCP configuration.

Configure Claude Code, Codex or Cursor once

Permissions and results

If you have more than one workspace, check the selected workspace in the connection or API-key dialog before saving. Roles, enabled commands, expiry and revocation use Tooluse.net's existing permissions. Disabling a connection or revoking a key immediately prevents new calls.

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Your connection's daily allowance and key permissions also apply. Adding a connection does not make a provider request.

Calls return the shared execution receipt and a Claude tool_result. Provider output varies by operation; consult the provider documentation for its response fields. Unconfirmed calls should be checked before retrying.

Call from your client

Use the shared MCP configuration. Refresh your client's tool list after saving the connection or changing key permissions, then call the returned tool name with the example input below.

Configure Claude Code, Codex or Cursor once

Discover your enabled tools

List permitted tools in Claude format. Read every page using page and size (maximum 100) until all results have been received. Use the returned name, not a catalog capability identifier, in the tool_use block.

curl 'https://api.tooluse.net/v1/tools' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"

Find this command in the tool list permitted by your key. Replace svc_FROM_YOUR_TOOL_LIST with its returned name. Use a new Idempotency-Key for each new call and retain it when retrying that same call.

HTTP call

curl 'https://api.tooluse.net/v1/tool-calls' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-new-call-id' \
  --data '{
  "type": "tool_use",
  "id": "toolu_example",
  "name": "svc_FROM_YOUR_TOOL_LIST",
  "input": {}
}'

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Commands

List Labs locations and languages — dataforseo.dataforseo_labs.locations_and_languages

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.

List AI mention locations and languages — dataforseo.ai_optimization.llm_mentions.locations_and_languages

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.

List Google search languages — dataforseo.serp.google.languages

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.

List Google Ads locations — dataforseo.keywords_data.google_ads.locations

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.

Parameter Type Required in parent Description Constraints
resource string Required Country code (for example us, gb) minLength: 2; maxLength: 2; pattern: "^[a-z]{2}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "resource": "cn"
}

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

List Google Ads languages — dataforseo.keywords_data.google_ads.languages

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.

List Google search locations — dataforseo.serp.google.locations

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.

Parameter Type Required in parent Description Constraints
resource string Required Country code (for example us, gb) minLength: 2; maxLength: 2; pattern: "^[a-z]{2}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "resource": "cn"
}

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

Keyword suggestions — dataforseo.dataforseo_labs.google.keyword_suggestions.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keyword string Required Keyword minLength: 1; maxLength: 253
tasks[].limit integer Required Return count minimum: 1; maximum: 1000
tasks[].include_serp_info boolean Optional
tasks[].include_clickstream_data boolean Optional
tasks[].include_seed_keyword boolean Optional

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.

Keyword ideas — dataforseo.dataforseo_labs.google.keyword_ideas.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keywords array Required Keywords (up to 10) minItems: 1; maxItems: 200
tasks[].keywords[] string Optional Keyword minLength: 1; maxLength: 100
tasks[].limit integer Required Return count minimum: 1; maximum: 1000
tasks[].include_serp_info boolean Optional
tasks[].include_clickstream_data boolean Optional
tasks[].ignore_synonyms boolean Optional
tasks[].order_by array Optional minItems: 1; maxItems: 3
tasks[].order_by[] string Optional minLength: 1; maxLength: 120; pattern: "^[A-Za-z0-9_.]+,(asc|desc)$"

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.

Keyword overview — dataforseo.dataforseo_labs.google.keyword_overview.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keywords array Required Keywords (up to 10) minItems: 1; maxItems: 700
tasks[].keywords[] string Optional Keyword minLength: 1; maxLength: 100
tasks[].include_serp_info boolean Optional
tasks[].include_clickstream_data boolean Optional

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.

Site ranking keywords — dataforseo.dataforseo_labs.google.ranked_keywords.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].target string Required Domain minLength: 1; maxLength: 2048
tasks[].limit integer Required Return count minimum: 1; maximum: 1000
tasks[].item_types array Optional minItems: 1; maxItems: 2; uniqueItems: true
tasks[].item_types[] string Optional enum: ["organic","paid"]
tasks[].include_clickstream_data boolean Optional
tasks[].ignore_synonyms boolean Optional
tasks[].historical_serp_mode string Optional enum: ["live"]
tasks[].load_rank_absolute boolean Optional
tasks[].order_by array Optional minItems: 1; maxItems: 3
tasks[].order_by[] string Optional minLength: 1; maxLength: 120; pattern: "^[A-Za-z0-9_.]+,(asc|desc)$"

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.

Site related pages — dataforseo.dataforseo_labs.google.relevant_pages.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].target string Required Domain minLength: 1; maxLength: 2048
tasks[].limit integer Required Return count minimum: 1; maximum: 1000
tasks[].item_types array Optional minItems: 1; maxItems: 2; uniqueItems: true
tasks[].item_types[] string Optional enum: ["organic","paid"]
tasks[].include_clickstream_data boolean Optional
tasks[].historical_serp_mode string Optional enum: ["live"]
tasks[].ignore_synonyms boolean Optional
tasks[].order_by array Optional minItems: 1; maxItems: 3
tasks[].order_by[] string Optional minLength: 1; maxLength: 120; pattern: "^[A-Za-z0-9_.]+,(asc|desc)$"

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.

Search competitor sites — dataforseo.dataforseo_labs.google.serp_competitors.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keywords array Required Keywords (up to 10) minItems: 1; maxItems: 1000
tasks[].keywords[] string Optional Keyword minLength: 1; maxLength: 100
tasks[].limit integer Required Return count minimum: 1; maximum: 1000
tasks[].item_types array Optional minItems: 1; maxItems: 2; uniqueItems: true
tasks[].item_types[] string Optional enum: ["organic","paid"]
tasks[].include_subdomains boolean Optional
tasks[].order_by array Optional minItems: 1; maxItems: 3
tasks[].order_by[] string Optional minLength: 1; maxLength: 120; pattern: "^[A-Za-z0-9_.]+,(asc|desc)$"

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.

Google Ads keyword suggestions — dataforseo.keywords_data.google_ads.keywords_for_keywords.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keywords array Required Keywords (up to 10) minItems: 1; maxItems: 20
tasks[].keywords[] string Optional Keyword minLength: 1; maxLength: 100
tasks[].search_partners boolean Optional
tasks[].sort_by string Optional enum: ["relevance"]
tasks[].include_adult_keywords boolean Optional

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.

Look up keyword search volume — dataforseo.keywords_data.google_ads.search_volume.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keywords array Required Keywords (up to 10) minItems: 1; maxItems: 1000
tasks[].keywords[] string Optional Keyword minLength: 1; maxLength: 100
tasks[].search_partners boolean Optional

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.

Organic search results — dataforseo.serp.google.organic.live.advanced

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keyword string Required Search keyword minLength: 1; maxLength: 300
tasks[].depth integer Required Result depth minimum: 1; maximum: 700
tasks[].device string Optional enum: ["desktop","mobile"]

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.

Map search results — dataforseo.serp.google.maps.live.advanced

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Optional Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keyword string Required Search keyword minLength: 1; maxLength: 300
tasks[].depth integer Required Result depth minimum: 1; maximum: 100
tasks[].location_coordinate string Optional minLength: 5; maxLength: 100; pattern: "^[-0-9.,z]+$"
tasks[].device string Optional enum: ["desktop","mobile"]
tasks[].os string Optional enum: ["windows","macos","android","ios"]
tasks[].search_places boolean Optional
tasks[] — Optional anyOf[1]
tasks[] — Optional anyOf[2]

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.

Local search results — dataforseo.serp.google.local_finder.live.advanced

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Optional Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].keyword string Required Search keyword minLength: 1; maxLength: 300
tasks[].depth integer Required Result depth minimum: 1; maximum: 10
tasks[].location_coordinate string Optional minLength: 5; maxLength: 100; pattern: "^[-0-9.,z]+$"
tasks[] — Optional anyOf[1]
tasks[] — Optional anyOf[2]

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.

Read domain ranking overview — dataforseo.dataforseo_labs.google.domain_rank_overview.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query task (one per request) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].location_code integer Required Region code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 1; maxLength: 20
tasks[].target string Required Domain minLength: 1; maxLength: 2048
tasks[].ignore_synonyms boolean Optional
tasks[].limit integer Optional minimum: 1; maximum: 1000

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.

List LLM response models — dataforseo.ai-optimization.models

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.

Parameter Type Required in parent Description Constraints
engine string Optional Engine enum: ["chat_gpt","claude","gemini","perplexity"]

Full JSON Schema

Full JSON Schema

Example input

{
  "engine": "chat_gpt"
}

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

Read a queued Google organic SERP task — dataforseo.serp.google.organic.task_get.advanced

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.

Parameter Type Required in parent Description Constraints
taskId string Required Task id pattern: "^[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}$"

Full JSON Schema

Full JSON Schema

Example input

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

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

Queue a Google organic SERP task — dataforseo.serp.google.organic.task_post

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].keyword string Required Keyword minLength: 1; maxLength: 700
tasks[].location_code integer Required Location code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 2; maxLength: 12
tasks[].depth integer Optional Result depth minimum: 1; maximum: 700
tasks[].device string Optional Device enum: ["desktop","mobile"]

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.

Search business listings — dataforseo.business_data.business_listings.search.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional minProperties: 1; additionalProperties: false
tasks[].categories array Optional Categories minItems: 1; maxItems: 10
tasks[].categories[] string Optional minLength: 1; maxLength: 100
tasks[].title string Optional Business name minLength: 1; maxLength: 200
tasks[].description string Optional Description minLength: 1; maxLength: 200
tasks[].is_claimed boolean Optional Claimed on Google Maps
tasks[].location_coordinate string Optional Latitude,longitude,radius km pattern: "^-?\\d{1,3}(?:\\.\\d+)?,-?\\d{1,3}(?:\\.\\d+)?,\\d{1,4}(?:\\.\\d+)?$"
tasks[].limit integer Optional Result limit minimum: 1; maximum: 50
tasks[].order_by array Optional minItems: 1; maxItems: 3
tasks[].order_by[] string Optional minLength: 1; maxLength: 120; pattern: "^[A-Za-z0-9_.]+,(asc|desc)$"

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.

Read Google business questions and answers — dataforseo.business_data.google.questions_and_answers.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].keyword string Required Business name, cid or place_id minLength: 1; maxLength: 700
tasks[].location_code integer Optional Location code minimum: 1; maximum: 9999999
tasks[].language_code string Required Language code minLength: 2; maxLength: 12
tasks[].depth integer Optional Result depth minimum: 1; maximum: 100
tasks[].location_coordinate string Optional minLength: 5; maxLength: 100; pattern: "^[-0-9.,z]+$"
tasks[] — Optional anyOf[1]
tasks[] — Optional anyOf[2]

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.

Analyse one page on demand — dataforseo.on_page.instant_pages

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].url string Required Page URL maxLength: 2048; format: "uri"
tasks[].enable_javascript boolean Optional Execute JavaScript
tasks[].enable_browser_rendering boolean Optional Measure Core Web Vitals
tasks[].validate_micromarkup boolean Optional Validate structured data
tasks[].check_spell boolean Optional Check spelling
tasks[].accept_language string Optional Accept-Language minLength: 2; maxLength: 40

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 a Lighthouse audit — dataforseo.on_page.lighthouse.live.json

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].url string Required Page URL maxLength: 2048; format: "uri"
tasks[].for_mobile boolean Optional Emulate a mobile device
tasks[].categories array Optional Audit categories minItems: 1; maxItems: 4
tasks[].categories[] string Optional enum: ["seo","performance","best_practices","accessibility"]
tasks[].language_code string Optional Language code minLength: 2; maxLength: 12

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.

Validate a page's structured data — dataforseo.on_page.microdata

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].id string Required OnPage task id pattern: "^[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}$"
tasks[].url string Required Page URL maxLength: 2048; format: "uri"

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.

Ask an LLM and record its answer — dataforseo.ai-optimization.llm-response

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].user_prompt string Required Prompt minLength: 1; maxLength: 500
tasks[].model_name string Required Model minLength: 1; maxLength: 100
tasks[].system_message string Optional System message minLength: 1; maxLength: 500
tasks[].max_output_tokens integer Optional Output token ceiling minimum: 16; maximum: 4096
tasks[].web_search boolean Optional Allow web search
tasks[].force_web_search boolean Optional Require web search
tasks[].web_search_country_iso_code string Optional Search country minLength: 2; maxLength: 2
tasks[].use_reasoning boolean Optional Use model reasoning
engine string Optional Engine enum: ["chat_gpt","claude","gemini","perplexity"]

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.

Search LLM mentions — dataforseo.ai_optimization.llm_mentions.search_mentions.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].target array Required Target entities (up to 10) minItems: 1; maxItems: 10
tasks[].target[] object Optional minProperties: 1; additionalProperties: false
tasks[].target[].keyword string Optional Keyword minLength: 1; maxLength: 700
tasks[].target[].domain string Optional Domain minLength: 1; maxLength: 253
tasks[].target[].search_filter string Optional Filter enum: ["include","exclude"]
tasks[].target[].search_scope array Optional Search scope minItems: 1; maxItems: 5; uniqueItems: true
tasks[].target[].search_scope[] string Optional enum: ["any","sources","search_results","question","answer","brand_entities","fan_out_queries"]
tasks[].target[].include_subdomains boolean Optional Include subdomains
tasks[].target[].match_type string Optional Match type enum: ["word_match","partial_match"]
tasks[].location_code integer Optional Location code minimum: 1; maximum: 9999999
tasks[].language_code string Optional Language code minLength: 2; maxLength: 12
tasks[].platform string Optional Platform enum: ["chat_gpt","google"]
tasks[].limit integer Optional Result limit minimum: 1; maximum: 1000
tasks[].offset integer Optional Result offset minimum: 0; maximum: 1000000
tasks[].search_after_token string Optional Original result cursor minLength: 1; maxLength: 4096

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.

Summarise LLM mentions for one target set — dataforseo.ai_optimization.llm_mentions.target_metrics.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].target array Required Target entities (up to 10) minItems: 1; maxItems: 10
tasks[].target[] object Optional minProperties: 1; additionalProperties: false
tasks[].target[].keyword string Optional Keyword minLength: 1; maxLength: 700
tasks[].target[].domain string Optional Domain minLength: 1; maxLength: 253
tasks[].target[].search_filter string Optional Filter enum: ["include","exclude"]
tasks[].target[].search_scope array Optional Search scope minItems: 1; maxItems: 5; uniqueItems: true
tasks[].target[].search_scope[] string Optional enum: ["any","sources","search_results","question","answer","brand_entities","fan_out_queries"]
tasks[].target[].include_subdomains boolean Optional Include subdomains
tasks[].target[].match_type string Optional Match type enum: ["word_match","partial_match"]
tasks[].location_code integer Optional Location code minimum: 1; maximum: 9999999
tasks[].language_code string Optional Language code minLength: 2; maxLength: 12
tasks[].platform string Optional Platform enum: ["chat_gpt","google"]
tasks[].limit integer Optional Result limit minimum: 1; maximum: 1000
tasks[].internal_list_limit integer Optional Internal list limit minimum: 1; maximum: 10
tasks[].offset integer Optional Result offset minimum: 0; maximum: 1000000

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.

Rank the pages LLM answers cite — dataforseo.ai_optimization.llm_mentions.top_mentioned_pages.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].target array Required Target entities (up to 10) minItems: 1; maxItems: 10
tasks[].target[] object Optional minProperties: 1; additionalProperties: false
tasks[].target[].keyword string Optional Keyword minLength: 1; maxLength: 700
tasks[].target[].domain string Optional Domain minLength: 1; maxLength: 253
tasks[].target[].search_filter string Optional Filter enum: ["include","exclude"]
tasks[].target[].search_scope array Optional Search scope minItems: 1; maxItems: 5; uniqueItems: true
tasks[].target[].search_scope[] string Optional enum: ["any","sources","search_results","question","answer","brand_entities","fan_out_queries"]
tasks[].target[].include_subdomains boolean Optional Include subdomains
tasks[].target[].match_type string Optional Match type enum: ["word_match","partial_match"]
tasks[].location_code integer Optional Location code minimum: 1; maximum: 9999999
tasks[].language_code string Optional Language code minLength: 2; maxLength: 12
tasks[].platform string Optional Platform enum: ["chat_gpt","google"]
tasks[].limit integer Optional Result limit minimum: 1; maximum: 1000
tasks[].links_scope string Optional Links scope enum: ["sources","search_results"]
tasks[].offset integer Optional Result offset minimum: 0; maximum: 1000000
tasks[].internal_list_limit integer Optional Internal list limit minimum: 1; maximum: 10

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.

Compare LLM mentions across target sets — dataforseo.ai_optimization.llm_mentions.multi_target_metrics.live

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.

Parameter Type Required in parent Description Constraints
tasks array Required Query tasks (1 per call) minItems: 1; maxItems: 1
tasks[] object Optional additionalProperties: false
tasks[].targets array Required Target sets (2 to 10) minItems: 2; maxItems: 10
tasks[].targets[] object Optional additionalProperties: false
tasks[].targets[].key string Required Set name minLength: 1; maxLength: 100
tasks[].targets[].target array Required Target entities (up to 10) minItems: 1; maxItems: 10
tasks[].targets[].target[] object Optional minProperties: 1; additionalProperties: false
tasks[].targets[].target[].keyword string Optional Keyword minLength: 1; maxLength: 700
tasks[].targets[].target[].domain string Optional Domain minLength: 1; maxLength: 253
tasks[].targets[].target[].search_filter string Optional Filter enum: ["include","exclude"]
tasks[].targets[].target[].search_scope array Optional Search scope minItems: 1; maxItems: 5; uniqueItems: true
tasks[].targets[].target[].search_scope[] string Optional enum: ["any","sources","search_results","question","answer","brand_entities","fan_out_queries"]
tasks[].targets[].target[].include_subdomains boolean Optional Include subdomains
tasks[].targets[].target[].match_type string Optional Match type enum: ["word_match","partial_match"]
tasks[].location_code integer Optional Location code minimum: 1; maximum: 9999999
tasks[].language_code string Optional Language code minLength: 2; maxLength: 12
tasks[].platform string Optional Platform enum: ["chat_gpt","google"]
tasks[].limit integer Optional Result limit minimum: 1; maximum: 1000
tasks[].offset integer Optional Result offset minimum: 0; maximum: 1000000
tasks[].internal_list_limit integer Optional Internal list limit minimum: 1; maximum: 10

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.

Errors

Check the key's expiry, revocation, workspace and allowed operations.

Reuse the same idempotency key only for the same request.

The connection or provider limit has been reached. Check the receipt before retrying.

Test the connection

Open the integration's commands below to inspect parameters and examples. Start with a read command for an account or resource you can access. Refresh your client's tool list, use the returned tool name, and check the execution result and usage. Provider charges and permissions still apply. Never test a write against production data without reviewing it.

Official provider documentation

Source: https://help.tooluse.net/integrations/dataforseo/index.mdx