Dataforseo MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'dataforseomcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Dataforseo MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'dataforseomcp_business_data_business_listings_search',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "dataforseomcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Dataforseo MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="dataforseomcp_business_data_business_listings_search",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Advanced serp youtube video subtitles live, serp youtube video info live, serp youtube video comments live — Get subtitle text for a YouTube video by video ID and language
• Locations serp youtube, serp, merchant amazon — List available locations for YouTube SERP data queries
• Lighthouse on page — Run a Lighthouse performance and SEO audit for a web page URL
• Pages on page instant, dataforseo labs google relevant, backlinks domain — Get on-page SEO data for a URL including metadata, links, and content metrics
• Parsing on page content — Extract and parse text content from a web page URL
• Explore kw data google trends, kw data dfs trends — Get Google Trends data for keywords over a time range and location

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

dataforseomcp_ai_opt_kw_data_loc_and_lang#List available locations and languages for AI keyword data searches.0 params▾

List available locations and languages for AI keyword data searches.

dataforseomcp_ai_opt_llm_ment_agg_metrics#Get aggregated LLM mention metrics for target domains or keywords across AI platforms.6 params▾

Get aggregated LLM mention metrics for target domains or keywords across AI platforms.

NameTypeRequiredDescription

targetarrayrequiredArray of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limitnumberoptionalInternal parameter to limit the number of items processed. Not exposed to end-users.

language_codestringoptionalSearch engine language code (e.g., 'en')

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

platformstringoptionalPlatform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_cross_agg_metrics#Compare LLM mention metrics across multiple targets using cross-aggregated analysis.6 params▾

Compare LLM mention metrics across multiple targets using cross-aggregated analysis.

NameTypeRequiredDescription

targetsarrayrequiredarray of objects containing target entities with aggregation keys. you can specify up to 10, but not less than 2

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limitnumberoptionalInternal parameter to limit the number of items processed. Not exposed to end-users.

language_codestringoptionalSearch engine language code (e.g., 'en')

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

platformstringoptionalPlatform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_loc_and_lang#List available locations and languages for LLM mention searches.0 params▾

List available locations and languages for LLM mention searches.

dataforseomcp_ai_opt_llm_ment_search#Search for LLM mentions of target domains or keywords across AI platforms.7 params▾

Search for LLM mentions of target domains or keywords across AI platforms.

NameTypeRequiredDescription

targetarrayrequiredArray of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

language_codestringoptionalSearch engine language code (e.g., 'en')

limitnumberoptionalNumber of results to return. Default is 10, maximum is 1000.

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

order_byarrayoptionalresuresults sorting rules

platformstringoptionalPlatform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_top_domains#Get the top domains mentioned in LLM responses for specified targets.8 params▾

Get the top domains mentioned in LLM responses for specified targets.

NameTypeRequiredDescription

targetarrayrequiredArray of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

initial_dataset_filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limitnumberoptionalmaximum number of elements within internal arrays, min value is 1, max value is 10

items_list_limitnumberoptionalmaximum number of results in the items array, min value is 1, max value is 10

language_codestringoptionalSearch engine language code (e.g., 'en')

links_scopestringoptionalspecifies which links will be used to extract domains and aggregation

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

platformstringoptionalPlatform to search for LLM mentions

dataforseomcp_ai_opt_llm_ment_top_pages#Get the top pages mentioned in LLM responses for specified targets.8 params▾

Get the top pages mentioned in LLM responses for specified targets.

NameTypeRequiredDescription

targetarrayrequiredArray of target objects to search for LLM mentions. Each object must contain either 'domain' or 'keyword'. Maximum number of targets: 1000

initial_dataset_filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

internal_list_limitnumberoptionalmaximum number of elements within internal arrays, min value is 1, max value is 10

items_list_limitnumberoptionalmaximum number of results in the items array, min value is 1, max value is 10

language_codestringoptionalSearch engine language code (e.g., 'en')

links_scopestringoptionalspecifies which links will be used to extract domains and aggregation

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

platformstringoptionalPlatform to search for LLM mentions

dataforseomcp_ai_optimization_chat_gpt_scraper#Retrieve AI-generated responses for a keyword from ChatGPT.4 params▾

Retrieve AI-generated responses for a keyword from ChatGPT.

NameTypeRequiredDescription

keywordstringrequiredkeyword

language_codestringrequiredSearch engine language code (e.g., 'en')

force_web_searchbooleanoptionalforce AI agent to use web search

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

dataforseomcp_ai_optimization_chat_gpt_scraper_locations#List available locations for ChatGPT scraper results.2 params▾

List available locations for ChatGPT scraper results.

NameTypeRequiredDescription

country_iso_codestringoptionalISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_namestringoptionalName of location or it`s part.

dataforseomcp_ai_optimization_keyword_data_search_volume#Get AI search volume data for keywords across AI platforms.3 params▾

Get AI search volume data for keywords across AI platforms.

NameTypeRequiredDescription

keywordsarrayrequiredKeywords. The maximum number of keywords you can specify: 1000

language_codestringrequiredSearch engine language code (e.g., 'en')

location_namestringoptionalfull name of the location, example: 'United Kingdom', 'United States'

dataforseomcp_ai_optimization_llm_mentions_filters#List available filter fields and operators for LLM mention queries.0 params▾

List available filter fields and operators for LLM mention queries.

dataforseomcp_ai_optimization_llm_models#List supported AI models available for LLM mention analysis.1 param▾

List supported AI models available for LLM mention analysis.

NameTypeRequiredDescription

llm_typestringrequiredtype of llm. Must be one of: 'claude', 'gemini', 'chat_gpt', 'perplexity'

dataforseomcp_ai_optimization_llm_response#Send a prompt to a specified LLM and retrieve its AI-generated response.6 params▾

Send a prompt to a specified LLM and retrieve its AI-generated response.

NameTypeRequiredDescription

llm_typestringrequiredtype of llm. Must be one of: 'claude', 'gemini', 'chat_gpt', 'perplexity'

model_namestringrequiredname of the AI model. consists of the actual model name and version name. if not sure which model to use, first call the ai_optimization_llm_models tool to get list of available models for the specified llm_type

user_promptstringrequiredPrompt for the AI model. The question or task you want to send to the AI model. You can specify up to 500 characters in the user_prompt field

temperaturenumberoptionalrandomness of the AI response optional field higher values make output more diverse; lower values make output more focused;

top_pnumberoptionaldiversity of the AI response, optional field, controls diversity of the response by limiting token selection;

web_searchbooleanoptionalenable web search for current information. When enabled, the AI model can access and cite current web information;

dataforseomcp_backlinks_anchors#Get anchor text distribution for backlinks pointing to a target domain or page.5 params▾

Get anchor text distribution for backlinks pointing to a target domain or page.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned anchors

offsetnumberoptionaloffset in the results array of returned anchors

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_available_filters#List available filter fields and operators for backlinks queries.1 param▾

List available filter fields and operators for backlinks queries.

NameTypeRequiredDescription

toolstringoptionalThe name of the tool to get filters for

dataforseomcp_backlinks_backlinks#Get a list of backlinks pointing to a target domain, subdomain, or page.6 params▾

Get a list of backlinks pointing to a target domain, subdomain, or page.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned backlinks

modestringoptionalresults grouping type

offsetnumberoptionaloffset in the results array of the returned backlinks

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_bulk_backlinks#Get backlink counts for multiple targets in a single request.1 param▾

Get backlink counts for multiple targets in a single request.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

dataforseomcp_backlinks_bulk_new_lost_backlinks#Get new and lost backlink counts for multiple targets over a time period.2 params▾

Get new and lost backlink counts for multiple targets over a time period.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

date_fromstringoptionalstarting date of the time range

dataforseomcp_backlinks_bulk_new_lost_referring_domains#Get new and lost referring domain counts for multiple targets over a time period.2 params▾

Get new and lost referring domain counts for multiple targets over a time period.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

date_fromstringoptionalstarting date of the time range

dataforseomcp_backlinks_bulk_pages_summary#Get page-level backlink summary data for multiple target pages.2 params▾

Get page-level backlink summary data for multiple target pages.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get summary data for

include_subdomainsbooleanoptionalindicates if indirect links to the target will be included in the results

dataforseomcp_backlinks_bulk_ranks#Get domain rank scores for multiple targets in a single request.2 params▾

Get domain rank scores for multiple targets in a single request.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

rank_scalestringoptionaldefines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values

dataforseomcp_backlinks_bulk_referring_domains#Get referring domain counts for multiple targets in a single request.1 param▾

Get referring domain counts for multiple targets in a single request.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

dataforseomcp_backlinks_bulk_spam_score#Get spam scores for multiple target domains in a single request.1 param▾

Get spam scores for multiple target domains in a single request.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get rank for

dataforseomcp_backlinks_competitors#Find competitor domains based on shared backlink profiles.8 params▾

Find competitor domains based on shared backlink profiles.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

exclude_internal_backlinksbooleanoptionalindicates if internal backlinks from subdomains to the target will be excluded from the results

exclude_large_domainsbooleanoptionalindicates whether large domain will appear in results

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned domains

main_domainbooleanoptionalindicates if only main domain of the target will be included in the search

offsetnumberoptionaloffset in the results array of returned networks

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_domain_intersection#Find domains whose backlinks intersect with multiple specified targets.5 params▾

Find domains whose backlinks intersect with multiple specified targets.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get links for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned results

offsetnumberoptionaloffset in the array of returned results

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_domain_pages#Get backlink data for individual pages within a target domain.5 params▾

Get backlink data for individual pages within a target domain.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned pages

offsetnumberoptionaloffset in the results array of returned pages

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_domain_pages_summary#Get a summary of backlink metrics for all pages within a target domain.5 params▾

Get a summary of backlink metrics for all pages within a target domain.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned anchors

offsetnumberoptionaloffset in the results array of returned anchors

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_page_intersection#Find pages that share backlinks with multiple specified target pages.5 params▾

Find pages that share backlinks with multiple specified target pages.

NameTypeRequiredDescription

targetsarrayrequireddomains, subdomains or webpages to get links for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned results

offsetnumberoptionaloffset in the array of returned results

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_referring_domains#Get referring domains pointing to a target domain, subdomain, or page.5 params▾

Get referring domains pointing to a target domain, subdomain, or page.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned pages

offsetnumberoptionaloffset in the results array of returned pages

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_referring_networks#Get referring IP networks and subnets for a target domain.6 params▾

Get referring IP networks and subnets for a target domain.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

limitnumberoptionalthe maximum number of returned networks

network_address_typestringoptionalindicates the type of network to get data for

offsetnumberoptionaloffset in the results array of returned networks

order_byarrayoptionalresults sorting rules

dataforseomcp_backlinks_summary#Get an overview of backlinks data for a target domain, subdomain, or page.3 params▾

Get an overview of backlinks data for a target domain, subdomain, or page.

NameTypeRequiredDescription

targetstringrequireddomain, subdomain or webpage to get backlinks for

exclude_internal_backlinksbooleanoptionalindicates if internal backlinks from subdomains to the target will be excluded from the results

include_subdomainsbooleanoptionalindicates if indirect links to the target will be included in the results

dataforseomcp_backlinks_timeseries_new_lost_summary#Get a timeseries summary of new and lost backlinks for a target domain.4 params▾

Get a timeseries summary of new and lost backlinks for a target domain.

NameTypeRequiredDescription

targetstringrequireddomain to get data for

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

group_rangestringoptionaltime range which will be used to group the results

dataforseomcp_backlinks_timeseries_summary#Get a timeseries summary of backlink metrics for a target domain.4 params▾

Get a timeseries summary of backlink metrics for a target domain.

NameTypeRequiredDescription

targetstringrequireddomain to get data for

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

group_rangestringoptionaltime range which will be used to group the results

dataforseomcp_business_data_business_listings_search#Search for local business listings by keyword and location.9 params▾

Search for local business listings by keyword and location.

NameTypeRequiredDescription

categoriesarrayoptionalbusiness categories

descriptionstringoptionaldescription of the element in SERP

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

is_claimedbooleanoptionalindicates whether the business is verified by its owner on Google Maps

limitnumberoptionalthe maximum number of returned businesses

location_coordinatestringoptionalGPS coordinates of a location

offsetnumberoptionaloffset in the results array of returned businesses

order_byarrayoptionalresults sorting rules

titlestringoptionaltitle of the element in SERP

dataforseomcp_content_analysis_phrase_trends#Analyze trends over time for a search phrase in web content.8 params▾

Analyze trends over time for a search phrase in web content.

NameTypeRequiredDescription

date_fromstringrequiredstarting date of the time range

keywordstringrequiredtarget keyword

date_groupstringoptionaldate grouping type

date_tostringoptionalending date of the time range

initial_dataset_filtersarrayoptionalArray-based initial dataset filter expression applied to Search endpoint fields. A single condition is a 3-element array: [field, operator, value]. Combine c...

internal_list_limitnumberoptionalmaximum number of elements within internal arrays

keyword_fieldsobjectoptionaltarget keyword fields and target keywords

page_typearrayoptionaltarget page types

dataforseomcp_content_analysis_search#Search for web pages containing a keyword and retrieve content analysis data.8 params▾

Search for web pages containing a keyword and retrieve content analysis data.

NameTypeRequiredDescription

keywordstringrequiredtarget keyword

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

keyword_fieldsobjectoptionaltarget keyword fields and target keywords

limitnumberoptionalmaximum number of results to return

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

page_typearrayoptionaltarget page types

search_modestringoptionalresults grouping type

dataforseomcp_content_analysis_summary#Get an aggregated summary of content analysis data for a keyword.7 params▾

Get an aggregated summary of content analysis data for a keyword.

NameTypeRequiredDescription

keywordstringrequiredtarget keyword

initial_dataset_filtersarrayoptionalArray-based initial dataset filter expression applied to Search endpoint fields. A single condition is a 3-element array: [field, operator, value]. Combine c...

internal_list_limitnumberoptionalmaximum number of elements within internal arrays

keyword_fieldsobjectoptionaltarget keyword fields and target keywords

page_typearrayoptionaltarget page types

positive_connotation_thresholdnumberoptionalpositive connotation threshold

sentiments_connotation_thresholdnumberoptionalsentiment connotation threshold

dataforseomcp_dataforseo_labs_available_filters#List available filter fields and operators for DataForSEO Labs queries.1 param▾

List available filter fields and operators for DataForSEO Labs queries.

NameTypeRequiredDescription

toolstringoptionalThe name of the tool to get filters for

dataforseomcp_dataforseo_labs_bulk_keyword_difficulty#Get keyword difficulty scores for multiple keywords in a single request.3 params▾

Get keyword difficulty scores for multiple keywords in a single request.

NameTypeRequiredDescription

keywordsarrayrequiredtarget keywords

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_bulk_traffic_estimation#Get estimated organic traffic data for multiple domains in a single request.5 params▾

Get estimated organic traffic data for multiple domains in a single request.

NameTypeRequiredDescription

targetsarrayrequiredtarget domains, subdomains, and webpages.

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_competitors_domain#Find competitor domains that share keyword rankings with a target domain.11 params▾

Find competitor domains that share keyword rankings with a target domain.

NameTypeRequiredDescription

targetstringrequiredtarget domain

exclude_top_domainsbooleanoptionalindicates whether to exclude world's largest websites

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_domain_intersection#Find keywords where multiple domains rank together in Google search results.12 params▾

Find keywords where multiple domains rank together in Google search results.

NameTypeRequiredDescription

target1stringrequiredtarget domain 1

target2stringrequiredtarget domain 2

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

intersectionsbooleanoptionaldomain intersections in SERP

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_domain_rank_overview#Get an overview of organic and paid ranking metrics for a domain.4 params▾

Get an overview of organic and paid ranking metrics for a domain.

NameTypeRequiredDescription

targetstringrequiredtarget domain

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_historical_keyword_data#Get historical search volume and competition data for a keyword.3 params▾

Get historical search volume and competition data for a keyword.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_historical_rank_overview#Get historical ranking metric trends for a domain over time.5 params▾

Get historical ranking metric trends for a domain over time.

NameTypeRequiredDescription

targetstringrequiredtarget domain

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_historical_serp#Get historical Google SERP results for a keyword at a specified date.3 params▾

Get historical Google SERP results for a keyword at a specified date.

NameTypeRequiredDescription

keywordstringrequiredtarget keyword

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_keyword_ideas#Generate keyword ideas and related terms based on a seed keyword and location.8 params▾

Generate keyword ideas and related terms based on a seed keyword and location.

NameTypeRequiredDescription

keywordsarrayrequiredtarget keywords

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_keyword_overview#Get search volume, competition, and CPC data for a keyword.4 params▾

Get search volume, competition, and CPC data for a keyword.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_dataforseo_labs_google_keyword_suggestions#Get keyword suggestions related to a seed keyword for a location.8 params▾

Get keyword suggestions related to a seed keyword for a location.

NameTypeRequiredDescription

keywordstringrequiredtarget keyword

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_keywords_for_site#Get keywords that a domain ranks for in Google organic search results.9 params▾

Get keywords that a domain ranks for in Google organic search results.

NameTypeRequiredDescription

targetstringrequiredtarget domain

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

include_subdomainsbooleanoptionalInclude keywords from subdomains

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_page_intersection#Find keywords where multiple URLs rank together in Google results.12 params▾

Find keywords where multiple URLs rank together in Google results.

NameTypeRequiredDescription

pagesarrayrequiredpages array

exclude_pagesarrayoptionalURLs of pages you want to exclude

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

intersection_modestringoptionalindicates whether to intersect keywords

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_ranked_keywords#Get all keywords a domain or URL ranks for in Google organic search.10 params▾

Get all keywords a domain or URL ranks for in Google organic search.

NameTypeRequiredDescription

targetstringrequireddomain name or page url

filtersarrayoptionalArray of filter conditions and logical operators. Each filter condition is an array of [field, operator, value].

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

include_subdomainsbooleanoptionalInclude keywords from subdomains

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_related_keywords#Get related keywords for a seed keyword with search volume and CPC data.9 params▾

Get related keywords for a seed keyword with search volume and CPC data.

NameTypeRequiredDescription

keywordstringrequiredtarget keyword

depthnumberoptionalkeyword search depth

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_relevant_pages#Get pages from a domain that rank for a specified keyword.11 params▾

Get pages from a domain that rank for a specified keyword.

NameTypeRequiredDescription

targetstringrequiredtarget domain

exclude_top_domainsbooleanoptionalindicates whether to exclude world’s largest websites

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_serp_competitors#Find domains competing for the same keywords in Google search results.9 params▾

Find domains competing for the same keywords in Google search results.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords array

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_subdomainsbooleanoptionalInclude keywords from subdomains

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_subdomains#Get organic ranking metrics broken down by subdomain for a target domain.10 params▾

Get organic ranking metrics broken down by subdomain for a target domain.

NameTypeRequiredDescription

targetstringrequiredtarget domain

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

ignore_synonymsbooleanoptionalignore highly similar keywords, if set to true, results will be more accurate

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

item_typesarrayoptionaldisplay results by item type

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresults sorting rules

dataforseomcp_dataforseo_labs_google_top_searches#Get top searched keywords for a specified location and language.7 params▾

Get top searched keywords for a specified location and language.

NameTypeRequiredDescription

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

include_clickstream_databooleanoptionalInclude or exclude data from clickstream-based metrics in the result

language_codestringoptionallanguage code

limitnumberoptionalMaximum number of keywords to return

location_namestringoptionalfull name of the location

offsetnumberoptionaloffset in the results array of returned keywords

order_byarrayoptionalresuresults sorting rules

dataforseomcp_dataforseo_labs_search_intent#Classify the search intent (informational, navigational, transactional) for keywords.2 params▾

Classify the search intent (informational, navigational, transactional) for keywords.

NameTypeRequiredDescription

keywordsarrayrequiredtarget keywords

language_codestringoptionallanguage code

dataforseomcp_domain_analytics_technologies_available_filters#List available filter fields and operators for domain technology queries.1 param▾

List available filter fields and operators for domain technology queries.

NameTypeRequiredDescription

toolstringoptionalThe name of the tool to get filters for

dataforseomcp_domain_analytics_technologies_domain_technologies#Get the web technologies and CMS platforms detected on a target domain.1 param▾

Get the web technologies and CMS platforms detected on a target domain.

NameTypeRequiredDescription

targetstringrequiredtarget domain

dataforseomcp_domain_analytics_whois_available_filters#List available filter fields and operators for WHOIS data queries.1 param▾

List available filter fields and operators for WHOIS data queries.

NameTypeRequiredDescription

toolstringoptionalThe name of the tool to get filters for

dataforseomcp_domain_analytics_whois_overview#Get WHOIS registration data and domain ownership information.5 params▾

Get WHOIS registration data and domain ownership information.

NameTypeRequiredDescription

filtersarrayoptionalArray-based filter expression. A single condition is a 3-element array: [field, operator, value]. Combine conditions with ["and"|"or"] between them: [conditi...

is_claimedbooleanoptionalindicates whether the business is verified by its owner on Google Maps

limitnumberoptionalthe maximum number of returned domains

offsetnumberoptionaloffset in the results array of returned businesses

order_byarrayoptionalresults sorting rules

dataforseomcp_kw_data_dfs_trends_demography#Get demographic breakdown of search interest for a keyword by location.6 params▾

Get demographic breakdown of search interest for a keyword by location.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

location_namestringoptionalfull name of the location

time_rangestringoptionalpreset time ranges

typestringoptionaldataforseo trends type

dataforseomcp_kw_data_dfs_trends_explore#Explore search trend data for keywords over a specified time range and location.6 params▾

Explore search trend data for keywords over a specified time range and location.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

location_namestringoptionalfull name of the location

time_rangestringoptionalpreset time ranges

typestringoptionaldataforseo trends type

dataforseomcp_kw_data_dfs_trends_subregion_interests#Get search interest data for a keyword broken down by subregion.6 params▾

Get search interest data for a keyword broken down by subregion.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

location_namestringoptionalfull name of the location

time_rangestringoptionalpreset time ranges

typestringoptionaldataforseo trends type

dataforseomcp_kw_data_google_ads_locations#List available locations for Google Ads keyword data.3 params▾

List available locations for Google Ads keyword data.

NameTypeRequiredDescription

country_iso_codestringrequiredISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_namestringoptionalName of location or it`s part.

location_typestringoptionalType of location. Possible variants: 'TV Region','Postal Code','Neighborhood','Governorate','National Park','Quarter','Canton','Airport','Okrug','Prefecture','City','Country','Province','Barrio','Sub-District','Congressional District','Municipality District','district','DMA Region','Union Territory','Territory','Colloquial Area','Autonomous Community','Borough','County','State','District','City Region','Commune','Region','Department','Division','Sub-Ward','Municipality','University'

dataforseomcp_kw_data_google_ads_search_volume#Get Google Ads search volume and competition data for keywords.3 params▾

Get Google Ads search volume and competition data for keywords.

NameTypeRequiredDescription

keywordsarrayrequiredArray of keywords to get search volume for

language_codestringoptionalLanguage two-letter ISO code (e.g., 'en').

location_namestringoptionalfull name of the location

dataforseomcp_kw_data_google_trends_categories#List available categories for filtering Google Trends data.0 params▾

List available categories for filtering Google Trends data.

dataforseomcp_kw_data_google_trends_explore#Get Google Trends data for keywords over a time range and location.9 params▾

Get Google Trends data for keywords over a time range and location.

NameTypeRequiredDescription

keywordsarrayrequiredkeywords

category_codenumberoptionalgoogle trends search category

date_fromstringoptionalstarting date of the time range

date_tostringoptionalending date of the time range

item_typesarrayoptionaltypes of items returned

language_codestringoptionalLanguage two-letter ISO code (e.g., 'en').

location_namestringoptionalfull name of the location

time_rangestringoptionalpreset time ranges

typestringoptionalgoogle trends type

dataforseomcp_merchant_amazon_asin_live_advanced#Get detailed product information for an Amazon product by ASIN.3 params▾

Get detailed product information for an Amazon product by ASIN.

NameTypeRequiredDescription

asinstringrequiredproduct ID

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_merchant_amazon_locations#List available locations for Amazon product search results.4 params▾

List available locations for Amazon product search results.

NameTypeRequiredDescription

countrystringoptionalISO 3166-1 alpha-2 country code to filter locations by

limitnumberoptionalmaximum number of locations to return

location_name_containsstringoptionalfilter locations by a substring match on location_name

offsetnumberoptionaloffset in the results array of returned locations

dataforseomcp_merchant_amazon_products_live_advanced#Search Amazon products by keyword and retrieve live product results.7 params▾

Search Amazon products by keyword and retrieve live product results.

NameTypeRequiredDescription

keywordstringrequiredkeyword

departmentstringoptionalamazon product department

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

price_maxintegeroptionalmaximum product price

price_minintegeroptionalminimum product price

sort_bystringoptionalresults sorting rules

dataforseomcp_merchant_amazon_sellers_live_advanced#Get seller information for an Amazon product by ASIN.3 params▾

Get seller information for an Amazon product by ASIN.

NameTypeRequiredDescription

asinstringrequiredproduct identifier (ASIN) on Amazon

language_codestringoptionallanguage code

location_namestringoptionalfull name of the location

dataforseomcp_on_page_content_parsing#Extract and parse text content from a web page URL.4 params▾

Extract and parse text content from a web page URL.

NameTypeRequiredDescription

urlstringrequiredURL of the page to parse

accept_languagestringoptionalAccept-Language header value

custom_user_agentstringoptionalCustom User-Agent header

enable_javascriptbooleanoptionalEnable JavaScript rendering

dataforseomcp_on_page_instant_pages#Get on-page SEO data for a URL including metadata, links, and content metrics.5 params▾

Get on-page SEO data for a URL including metadata, links, and content metrics.

NameTypeRequiredDescription

urlstringrequiredURL to analyze

accept_languagestringoptionallanguage header for accessing the website

custom_jsstringoptionalCustom JavaScript code to execute

custom_user_agentstringoptionalCustom User-Agent header

enable_javascriptbooleanoptionalEnable JavaScript rendering

dataforseomcp_on_page_lighthouse#Run a Lighthouse performance and SEO audit for a web page URL.5 params▾

Run a Lighthouse performance and SEO audit for a web page URL.

NameTypeRequiredDescription

urlstringrequiredURL of the page to parse

accept_languagestringoptionalAccept-Language header value

custom_user_agentstringoptionalCustom User-Agent header

enable_javascriptbooleanoptionalEnable JavaScript rendering

full_databooleanoptionalReturn the complete API response instead of a reduced version

dataforseomcp_serp_locations#List available locations for SERP data queries.4 params▾

List available locations for SERP data queries.

NameTypeRequiredDescription

country_iso_codestringrequiredISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_namestringoptionalName of location or it`s part.

location_typestringoptionalType of location. Possible variants: 'TV Region','Postal Code','Neighborhood','Governorate','National Park','Quarter','Canton','Airport','Okrug','Prefecture','City','Country','Province','Barrio','Sub-District','Congressional District','Municipality District','district','DMA Region','Union Territory','Territory','Colloquial Area','Autonomous Community','Borough','County','State','District','City Region','Commune','Region','Department','Division','Sub-Ward','Municipality','University'

search_enginestringoptionalsearch engine name, one of: google, yahoo, bing.

dataforseomcp_serp_organic_live_advanced#Get live organic search results for a keyword from a specified search engine.8 params▾

Get live organic search results for a keyword from a specified search engine.

NameTypeRequiredDescription

keywordstringrequiredSearch keyword

language_codestringrequiredsearch engine language code (e.g., 'en')

depthnumberoptionalparsing depth

devicestringoptionaldevice type

location_namestringoptionalfull name of the location

max_crawl_pagesnumberoptionalpage crawl limit

people_also_ask_click_depthnumberoptionalclicks on the corresponding element

search_enginestringoptionalsearch engine name, one of: google, yahoo, bing.

dataforseomcp_serp_youtube_locations#List available locations for YouTube SERP data queries.3 params▾

List available locations for YouTube SERP data queries.

NameTypeRequiredDescription

country_iso_codestringrequiredISO 3166-1 alpha-2 country code, for example: US, GB, MT

location_namestringoptionalName of location or it`s part.

location_typestringoptionalType of location. Possible variants: 'TV Region','Postal Code','Neighborhood','Governorate','National Park','Quarter','Canton','Airport','Okrug','Prefecture','City','Country','Province','Barrio','Sub-District','Congressional District','Municipality District','district','DMA Region','Union Territory','Territory','Colloquial Area','Autonomous Community','Borough','County','State','District','City Region','Commune','Region','Department','Division','Sub-Ward','Municipality','University'

dataforseomcp_serp_youtube_organic_live_advanced#Get live YouTube search results for a keyword.6 params▾

Get live YouTube search results for a keyword.

NameTypeRequiredDescription

keywordstringrequiredSearch keyword

language_codestringrequiredsearch engine language code (e.g., 'en')

location_namestringrequiredfull name of the location

block_depthnumberoptionalparsing depth

devicestringoptionaldevice type

osstringoptionaldevice operating system

dataforseomcp_serp_youtube_video_comments_live_advanced#Get user comments for a YouTube video by video ID.6 params▾

Get user comments for a YouTube video by video ID.

NameTypeRequiredDescription

language_codestringrequiredsearch engine language code (e.g., 'en')

location_namestringrequiredfull name of the location

video_idstringrequiredID of the video

depthnumberoptionalparsing depth, number of results in SERP, max value: 700

devicestringoptionaldevice type

osstringoptionaldevice operating system

dataforseomcp_serp_youtube_video_info_live_advanced#Get metadata and details for a YouTube video by video ID.5 params▾

Get metadata and details for a YouTube video by video ID.

NameTypeRequiredDescription

language_codestringrequiredsearch engine language code (e.g., 'en')

location_namestringrequiredfull name of the location

video_idstringrequiredID of the video

devicestringoptionaldevice type

osstringoptionaldevice operating system

dataforseomcp_serp_youtube_video_subtitles_live_advanced#Get subtitle text for a YouTube video by video ID and language.7 params▾

Get subtitle text for a YouTube video by video ID and language.

NameTypeRequiredDescription

language_codestringrequiredsearch engine language code (e.g., 'en')

location_namestringrequiredfull name of the location

video_idstringrequiredID of the video

devicestringoptionaldevice type

osstringoptionaldevice operating system

subtitles_languagestringoptionallanguage code of original text (e.g., 'en')

subtitles_translate_languagestringoptionallanguage code of translated text (e.g., 'en')