### Start and Get On-Page Website Analysis Tasks (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt This snippet demonstrates initiating a website crawl for on-page analysis and subsequently retrieving crawled pages with their SEO metrics. It configures the crawl with options like enabling JavaScript and loading resources. Replace 'login:password' with your credentials. ```bash # Start website crawl task curl -X POST https://api.dataforseo.com/v3/on_page/task_post \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "target": "example.com", "max_crawl_pages": 1000, "store_raw_html": true, "load_resources": true, "enable_javascript": true }]' # Get crawled pages with SEO metrics curl -X POST https://api.dataforseo.com/v3/on_page/pages \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "id": "task_id", "filters": ["is_broken", "=", false], "limit": 100 }]' ``` -------------------------------- ### Get Backlink Summary (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Fetches a summary of backlink data for a given domain, including the total count of referring domains. It supports including subdomains in the analysis. Authentication is required. ```bash curl -X POST https://api.dataforseo.com/v3/backlinks/summary/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "target": "example.com", "include_subdomains": true }]' ``` -------------------------------- ### Get Keyword Suggestions (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Generates keyword suggestions based on seed keywords, including options to include the seed keyword itself and set a limit on the number of suggestions. Useful for expanding keyword lists. Requires authentication. ```bash curl -X POST https://api.dataforseo.com/v3/keywords_data/google/keywords_for_keywords/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keywords": ["seo tools"], "location_code": 2840, "language_code": "en", "include_seed_keyword": true, "limit": 50 }]' ``` -------------------------------- ### Analyze Content Optimization and Get Summary (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt This bash script shows how to analyze content optimization for a given keyword and retrieve a summary of content metrics. The first command focuses on live search results ordered by social metrics, while the second fetches historical content data. Ensure to use your API credentials. ```bash # Analyze content optimization curl -X POST https://api.dataforseo.com/v3/content_analysis/search/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keyword": "content marketing strategy", "page_type": ["article"], "search_mode": "as_is", "order_by": ["social_metrics.total,desc"], "limit": 50 }]' # Get content summary and metrics curl -X POST https://api.dataforseo.com/v3/content_analysis/summary/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keyword": "content marketing strategy", "date_from": "2024-01-01", "date_to": "2025-01-01" }]' ``` -------------------------------- ### Get Google Business Reviews (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt This bash script initiates a task to retrieve reviews from Google Business Profile for a specified keyword and location. The 'depth' parameter controls the number of reviews to fetch. Replace 'login:password' with your API credentials. ```bash # Get Google Business reviews curl -X POST https://api.dataforseo.com/v3/business_data/google/reviews/task_post \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keyword": "DataForSEO", "location_code": 2840, "language_code": "en", "depth": 100 }]' ``` -------------------------------- ### Get Yelp Business Reviews (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt This bash script shows how to fetch reviews from a Yelp business profile. You need to provide the URL of the business page and specify the desired depth of reviews. Remember to use your actual API credentials for 'login:password'. ```bash # Get Yelp business reviews curl -X POST https://api.dataforseo.com/v3/business_data/yelp/reviews/task_post \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "url": "https://www.yelp.com/biz/business-name", "depth": 50 }]' ``` -------------------------------- ### Get Google SERP Results (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves real-time Google organic search results for a specified keyword. This endpoint requires authentication and accepts parameters like location, language, device, and depth. The response includes ranked items with titles and URLs. ```bash curl -X POST https://api.dataforseo.com/v3/serp/google/organic/live/advanced \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keyword": "best seo tools", "location_code": 2840, "language_code": "en", "device": "desktop", "os": "windows", "depth": 100 }]' ``` -------------------------------- ### Get Keyword Search Volume (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves search volume, competition, CPC, and keyword difficulty for a list of keywords in a specific location and language. This endpoint is essential for keyword research and planning. Requires authentication. ```bash curl -X POST https://api.dataforseo.com/v3/keywords_data/google/search_volume/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keywords": ["seo tools", "backlink checker", "rank tracker"], "location_code": 2840, "language_code": "en" }]' ``` -------------------------------- ### Get Ranked Keywords for a Domain (cURL) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Fetches a list of keywords for which a specified domain ranks in Google search results. It allows filtering by search volume, ordering by impressions, and setting a limit for the number of results. Requires authentication credentials. ```bash curl -X POST https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "target": "example.com", "location_code": 2840, "language_code": "en", "filters": ["search_volume", ">", 100], "order_by": ["impressions_etv,desc"], "limit": 1000 }]' ``` -------------------------------- ### Get Detailed Backlinks with Filters (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves detailed backlink information for a target domain, with options to filter by link type (e.g., dofollow), order results, and set a limit. This is useful for in-depth link analysis. Requires authentication. ```bash curl -X POST https://api.dataforseo.com/v3/backlinks/backlinks/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "target": "example.com", "mode": "as_is", "filters": ["dofollow", "=", true], "order_by": ["rank,desc"], "limit": 100 }]' ``` -------------------------------- ### Get Domain Metrics Overview (cURL) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves a set of key SEO metrics for one or more target domains. This includes metrics like organic keywords, organic traffic, paid keywords, and paid traffic. Supports specifying location and language codes for targeted analysis. Requires authentication. ```bash curl -X POST https://api.dataforseo.com/v3/dataforseo_labs/google/domain_metrics/live \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "targets": ["example.com", "competitor.com"], "location_code": 2840, "language_code": "en" }]' ``` -------------------------------- ### Set Up and Retrieve Rank Tracking Tasks (Bash) Source: https://context7.com/context7/dataforseo_api-docs/llms.txt This snippet demonstrates how to set up a rank tracking task by posting a request to the API with specified keywords, location, and language. It also shows how to retrieve the results of a completed task using its ID. Ensure you replace 'login:password' with your actual API credentials. ```bash # Set up rank tracking task curl -X POST https://api.dataforseo.com/v3/serp/google/organic/task_post \ -H "Content-Type: application/json" \ -u "login:password" \ -d '[{ "keyword": "seo software", "location_code": 2840, "language_code": "en", "device": "desktop", "tag": "rank-tracking-001" }]' # Retrieve rank tracking results curl -X POST https://api.dataforseo.com/v3/serp/google/organic/task_get/advanced/{task_id} \ -H "Content-Type: application/json" \ -u "login:password" ``` -------------------------------- ### Content Analysis API Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Analyze content quality, readability scores, keyword density, semantic relevance, and content structure. Provides competitor content comparison and recommendations for optimization. ```APIDOC ## POST /v3/content_analysis/search/live ### Description Analyzes content optimization based on a keyword, returning live search results. ### Method POST ### Endpoint https://api.dataforseo.com/v3/content_analysis/search/live ### Parameters #### Request Body - **keyword** (string) - Required - The keyword to analyze content for. - **page_type** (array) - Optional - Filters results by page type (e.g., `["article"]`). - **search_mode** (string) - Optional - Specifies how the search query should be treated (e.g., `"as_is"`). - **order_by** (array) - Optional - Specifies the order of results (e.g., `["social_metrics.total,desc"]`). - **limit** (integer) - Optional - The maximum number of results to return. Defaults to 50. ### Request Example ```json [ { "keyword": "content marketing strategy", "page_type": ["article"], "search_mode": "as_is", "order_by": ["social_metrics.total,desc"], "limit": 50 } ] ``` ## POST /v3/content_analysis/summary/live ### Description Retrieves a summary and metrics for content related to a keyword within a specified date range. ### Method POST ### Endpoint https://api.dataforseo.com/v3/content_analysis/summary/live ### Parameters #### Request Body - **keyword** (string) - Required - The keyword to analyze content for. - **date_from** (string) - Required - The start date for the analysis (YYYY-MM-DD). - **date_to** (string) - Required - The end date for the analysis (YYYY-MM-DD). ### Request Example ```json [ { "keyword": "content marketing strategy", "date_from": "2024-01-01", "date_to": "2025-01-01" } ] ``` ### Response #### Success Response - **tasks** (array) - An array containing task results. - **result** (array) - An array of content analysis results. - **total_count** (integer) - The total number of content items found. - **items** (array) - Details for each content item. - **type** (string) - The type of content (e.g., "article"). - **url** (string) - The URL of the content. - **title** (string) - The title of the content. - **word_count** (integer) - The word count of the content. - **social_metrics** (object) - Social media metrics. - **facebook** (integer) - Number of Facebook shares/interactions. #### Response Example ```json { "tasks": [ { "result": [ { "total_count": 1250, "items": [ { "type": "article", "url": "https://site.com/article", "title": "Content Marketing Guide", "word_count": 2500, "social_metrics": { "facebook": 450 } } ] } ] } ] } ``` ``` -------------------------------- ### POST /v3/dataforseo_labs/google/domain_metrics/live Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves key SEO metrics for one or more domains, including organic keywords, organic traffic, and top keywords. This endpoint is valuable for quick competitor analysis and understanding a domain's overall SEO health. ```APIDOC ## POST /v3/dataforseo_labs/google/domain_metrics/live ### Description Retrieves key SEO metrics for one or more domains, including organic keywords, organic traffic, and top keywords. This endpoint is valuable for quick competitor analysis and understanding a domain's overall SEO health. ### Method POST ### Endpoint https://api.dataforseo.com/v3/dataforseo_labs/google/domain_metrics/live ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body - **targets** (array of strings) - Required - A list of domains or URLs to retrieve metrics for. - **location_code** (integer) - Optional - The location code for the search results (e.g., 2840 for Los Angeles). - **language_code** (string) - Optional - The language code for the search results (e.g., "en" for English). ### Request Example ```json [ { "targets": ["example.com", "competitor.com"], "location_code": 2840, "language_code": "en" } ] ``` ### Response #### Success Response (200) - **target** (string) - The domain for which metrics were retrieved. - **organic_keywords** (integer) - The total number of organic keywords the domain ranks for. - **organic_traffic** (integer) - Estimated organic traffic to the domain. - **paid_keywords** (integer) - The total number of paid keywords the domain ranks for. - **paid_traffic** (integer) - Estimated paid traffic to the domain. - **top_keywords** (array) - An array of top ranking keywords with details. - **keyword** (string) - The keyword itself. - **position** (integer) - The ranking position for the keyword. - **search_volume** (integer) - The search volume for the keyword. #### Response Example ```json { "tasks": [ { "result": [ { "target": "example.com", "organic_keywords": 12450, "organic_traffic": 45000, "paid_keywords": 230, "paid_traffic": 3400, "top_keywords": [ { "keyword": "seo tools", "position": 3, "search_volume": 18100 } ] } ] } ] } ``` ``` -------------------------------- ### Backlinks API for Link Analysis Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Access comprehensive backlink profile data, including referring domains, anchor texts, and historical changes. Enables bulk analysis, competitor comparisons, and real-time link monitoring. ```APIDOC ## POST /v3/backlinks/summary/live ### Description Retrieves a summary of backlink data for a specified target domain. ### Method POST ### Endpoint https://api.dataforseo.com/v3/backlinks/summary/live ### Parameters #### Request Body - **target** (string) - Required - The domain for which to retrieve backlink summary. - **include_subdomains** (boolean) - Optional - Whether to include subdomains in the analysis. Defaults to false. ### Request Example ```json [ { "target": "example.com", "include_subdomains": true } ] ``` ### Response #### Success Response (200) - **status_code** (integer) - The status code of the operation. - **tasks** (array) - An array of task results. - **result** (array) - An array of summary results. - **target** (string) - The target domain. - **total_count** (integer) - The total number of backlinks found. - **items** (array) - An array of backlink summary items. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "target": "example.com", "total_count": 125430, "items": [] } ] } ] } ``` ## POST /v3/backlinks/backlinks/live ### Description Fetches detailed live backlink data for a given target, with options for filtering, sorting, and limiting results. ### Method POST ### Endpoint https://api.dataforseo.com/v3/backlinks/backlinks/live ### Parameters #### Request Body - **target** (string) - Required - The domain for which to retrieve backlinks. - **mode** (string) - Optional - The mode for retrieving backlinks (e.g., "as_is"). - **filters** (array) - Optional - An array of filters to apply (e.g., ["dofollow", "=", true]). - **order_by** (array) - Optional - An array of sorting criteria (e.g., ["rank,desc"]). - **limit** (integer) - Optional - The maximum number of results to return. Defaults to 100. ### Request Example ```json [ { "target": "example.com", "mode": "as_is", "filters": ["dofollow", "=", true], "order_by": ["rank,desc"], "limit": 100 } ] ``` ### Response #### Success Response (200) - **status_code** (integer) - The status code of the operation. - **tasks** (array) - An array of task results. - **result** (array) - An array of backlink items. - **type** (string) - The type of item (e.g., "backlink"). - **domain_from** (string) - The referring domain. - **url_from** (string) - The URL of the referring page. - **url_to** (string) - The target URL on the specified domain. - **anchor** (string) - The anchor text of the backlink. - **dofollow** (boolean) - Indicates if the backlink is dofollow. - **page_from_rank** (integer) - The PageRank of the referring page. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "target": "example.com", "total_count": 125430, "items": [ { "type": "backlink", "domain_from": "referrer.com", "url_from": "https://referrer.com/article", "url_to": "https://example.com/page", "anchor": "click here", "dofollow": true, "page_from_rank": 45 } ] } ] } ] } ``` ``` -------------------------------- ### POST /v3/dataforseo_labs/google/ranked_keywords/live Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieves a list of keywords for which a given domain ranks in Google search results, along with associated metrics. This endpoint is useful for understanding a domain's keyword performance and identifying ranking opportunities. ```APIDOC ## POST /v3/dataforseo_labs/google/ranked_keywords/live ### Description Retrieves a list of keywords for which a given domain ranks in Google search results, along with associated metrics. This endpoint is useful for understanding a domain's keyword performance and identifying ranking opportunities. ### Method POST ### Endpoint https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body - **target** (string) - Required - The target domain or URL to check. - **location_code** (integer) - Optional - The location code for the search results (e.g., 2840 for Los Angeles). - **language_code** (string) - Optional - The language code for the search results (e.g., "en" for English). - **filters** (array) - Optional - An array of filters to apply to the results (e.g., ["search_volume", ">", 100]). - **order_by** (array) - Optional - An array of sorting criteria (e.g., ["impressions_etv,desc"]). - **limit** (integer) - Optional - The maximum number of results to return. ### Request Example ```json [ { "target": "example.com", "location_code": 2840, "language_code": "en", "filters": ["search_volume", ">", 100], "order_by": ["impressions_etv,desc"], "limit": 1000 } ] ``` ### Response #### Success Response (200) - **target** (string) - The domain that was queried. - **organic_keywords** (integer) - The total number of organic keywords the domain ranks for. - **organic_traffic** (integer) - Estimated organic traffic to the domain. - **paid_keywords** (integer) - The total number of paid keywords the domain ranks for. - **paid_traffic** (integer) - Estimated paid traffic to the domain. - **top_keywords** (array) - An array of top ranking keywords with details. - **keyword** (string) - The keyword itself. - **position** (integer) - The ranking position for the keyword. - **search_volume** (integer) - The search volume for the keyword. #### Response Example ```json { "tasks": [ { "result": [ { "target": "example.com", "organic_keywords": 12450, "organic_traffic": 45000, "paid_keywords": 230, "paid_traffic": 3400, "top_keywords": [ { "keyword": "seo tools", "position": 3, "search_volume": 18100 } ] } ] } ] } ``` ``` -------------------------------- ### Rank Tracking API Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Monitor website rankings for target keywords across different search engines, locations, and devices. Track SERP position changes over time, compare competitor rankings, and analyze ranking distribution with automated daily, weekly, or monthly checks. ```APIDOC ## POST /v3/serp/google/organic/task_post ### Description Sets up a rank tracking task to monitor keyword rankings. ### Method POST ### Endpoint https://api.dataforseo.com/v3/serp/google/organic/task_post ### Parameters #### Request Body - **keyword** (string) - Required - The keyword to track. - **location_code** (integer) - Required - The code of the location for tracking. - **language_code** (string) - Required - The code of the language for tracking. - **device** (string) - Optional - The device to track (e.g., "desktop", "mobile"). Defaults to "desktop". - **tag** (string) - Optional - A tag for the task. ### Request Example ```json [ { "keyword": "seo software", "location_code": 2840, "language_code": "en", "device": "desktop", "tag": "rank-tracking-001" } ] ``` ## POST /v3/serp/google/organic/task_get/advanced/{task_id} ### Description Retrieves the results of a rank tracking task. ### Method POST ### Endpoint https://api.dataforseo.com/v3/serp/google/organic/task_get/advanced/{task_id} ### Parameters #### Path Parameters - **task_id** (string) - Required - The ID of the task to retrieve results for. ### Response #### Success Response (20000) - **id** (string) - The ID of the task. - **result** (array) - An array of tracking results, each containing keyword, search engine domain, and SERP items. - **items** (array) - SERP items including rank, domain, and URL. #### Response Example ```json { "status_code": 20000, "tasks": [ { "id": "12345678-1234-1234-1234-123456789012", "result": [ { "keyword": "seo software", "se_domain": "google.com", "items": [ { "type": "organic", "rank_group": 3, "rank_absolute": 3, "domain": "yoursite.com", "url": "https://yoursite.com/product" } ] } ] } ] } ``` ``` -------------------------------- ### SERP API for Search Engine Results Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Retrieve real-time and historical search engine results data from various search engines like Google and Bing. Supports detailed query customization for location, device, and language, and provides structured SERP features. ```APIDOC ## POST /v3/serp/google/organic/live/advanced ### Description Fetches live, advanced organic search engine results for a given keyword, location, and language. ### Method POST ### Endpoint https://api.dataforseo.com/v3/serp/google/organic/live/advanced ### Parameters #### Request Body - **keyword** (string) - Required - The search query. - **location_code** (integer) - Required - The ID of the location for the search. - **language_code** (string) - Required - The language of the search query. - **device** (string) - Optional - The device type (e.g., "desktop", "mobile"). - **os** (string) - Optional - The operating system (e.g., "windows", "mac"). - **depth** (integer) - Optional - The number of search results to retrieve. ### Request Example ```json [ { "keyword": "best seo tools", "location_code": 2840, "language_code": "en", "device": "desktop", "os": "windows", "depth": 100 } ] ``` ### Response #### Success Response (200) - **status_code** (integer) - The status code of the operation. - **tasks** (array) - An array of task results. - **result** (array) - An array of search result items. - **keyword** (string) - The keyword used for the search. - **type** (string) - The type of search result (e.g., "organic"). - **se_domain** (string) - The search engine domain. - **items** (array) - An array of SERP items. - **type** (string) - The type of item (e.g., "organic"). - **rank_group** (integer) - The rank group. - **rank_absolute** (integer) - The absolute rank. - **domain** (string) - The domain of the result. - **title** (string) - The title of the result. - **url** (string) - The URL of the result. - **description** (string) - The description of the result. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "keyword": "best seo tools", "type": "organic", "se_domain": "google.com", "items": [ { "type": "organic", "rank_group": 1, "rank_absolute": 1, "domain": "example.com", "title": "Top 10 Best SEO Tools", "url": "https://example.com/best-seo-tools", "description": "Comprehensive guide to SEO tools..." } ] } ] } ] } ``` ``` -------------------------------- ### On-Page API Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Perform comprehensive website crawling and on-page SEO analysis including page structure, meta tags, internal linking, content quality, and technical SEO issues. ```APIDOC ## POST /v3/on_page/task_post ### Description Starts a website crawl task for on-page analysis. ### Method POST ### Endpoint https://api.dataforseo.com/v3/on_page/task_post ### Parameters #### Request Body - **target** (string) - Required - The website domain or URL to crawl. - **max_crawl_pages** (integer) - Optional - The maximum number of pages to crawl. Defaults to 1000. - **store_raw_html** (boolean) - Optional - Whether to store the raw HTML of crawled pages. Defaults to false. - **load_resources** (boolean) - Optional - Whether to load resources (CSS, JS, images) during crawl. Defaults to false. - **enable_javascript** (boolean) - Optional - Whether to enable JavaScript rendering during crawl. Defaults to false. ### Request Example ```json [ { "target": "example.com", "max_crawl_pages": 1000, "store_raw_html": true, "load_resources": true, "enable_javascript": true } ] ``` ## POST /v3/on_page/pages ### Description Retrieves crawled pages with their associated SEO metrics. ### Method POST ### Endpoint https://api.dataforseo.com/v3/on_page/pages ### Parameters #### Request Body - **id** (string) - Required - The ID of the crawl task. - **filters** (array) - Optional - Filters to apply to the results (e.g., `["is_broken", "=", false]`). - **limit** (integer) - Optional - The maximum number of results to return. Defaults to 100. ### Request Example ```json [ { "id": "task_id", "filters": ["is_broken", "=", false], "limit": 100 } ] ``` ### Response #### Success Response - **tasks** (array) - An array containing task results. - **result** (array) - An array of crawled page data. - **items** (array) - Details for each crawled page. - **url** (string) - The URL of the crawled page. - **status_code** (integer) - The HTTP status code of the page. - **meta** (object) - Meta information including title and description. - **title** (string) - The page's meta title. - **description** (string) - The page's meta description. - **onpage_score** (integer) - The on-page SEO score. - **total_dom_size** (integer) - The total DOM size of the page. - **broken_links** (integer) - The number of broken links found on the page. #### Response Example ```json { "tasks": [ { "result": [ { "items": [ { "url": "https://example.com/page", "status_code": 200, "meta": { "title": "Page Title", "description": "Meta description" }, "onpage_score": 85, "total_dom_size": 45000, "broken_links": 0 } ] } ] } ] } ``` ``` -------------------------------- ### Keywords API for Keyword Research Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Obtain keyword metrics such as search volume, competition, CPC, and keyword difficulty. Also provides keyword suggestions, autocomplete data, and historical trend analysis. ```APIDOC ## POST /v3/keywords_data/google/search_volume/live ### Description Fetches keyword metrics including search volume, competition, and CPC for a list of keywords in a specified location and language. ### Method POST ### Endpoint https://api.dataforseo.com/v3/keywords_data/google/search_volume/live ### Parameters #### Request Body - **keywords** (array) - Required - An array of keywords to get data for. - **location_code** (integer) - Required - The ID of the location for the search. - **language_code** (string) - Required - The language of the keywords. ### Request Example ```json [ { "keywords": ["seo tools", "backlink checker", "rank tracker"], "location_code": 2840, "language_code": "en" } ] ``` ### Response #### Success Response (200) - **status_code** (integer) - The status code of the operation. - **tasks** (array) - An array of task results. - **result** (array) - An array of keyword data items. - **keyword** (string) - The keyword. - **location_code** (integer) - The location code. - **search_volume** (integer) - The monthly search volume for the keyword. - **competition** (float) - The competition level for the keyword. - **cpc** (float) - The average cost per click for the keyword. - **keyword_difficulty** (integer) - The estimated keyword difficulty. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "keyword": "seo tools", "location_code": 2840, "search_volume": 18100, "competition": 0.85, "cpc": 12.45, "keyword_difficulty": 67 } ] } ] } ``` ## POST /v3/keywords_data/google/keywords_for_keywords/live ### Description Generates keyword suggestions based on a list of seed keywords for a given location and language. ### Method POST ### Endpoint https://api.dataforseo.com/v3/keywords_data/google/keywords_for_keywords/live ### Parameters #### Request Body - **keywords** (array) - Required - An array of seed keywords. - **location_code** (integer) - Required - The ID of the location for the search. - **language_code** (string) - Required - The language of the keywords. - **include_seed_keyword** (boolean) - Optional - Whether to include the seed keywords in the results. Defaults to false. - **limit** (integer) - Optional - The maximum number of suggestions to return. Defaults to 100. ### Request Example ```json [ { "keywords": ["seo tools"], "location_code": 2840, "language_code": "en", "include_seed_keyword": true, "limit": 50 } ] ``` ### Response #### Success Response (200) - **status_code** (integer) - The status code of the operation. - **tasks** (array) - An array of task results. - **result** (array) - An array of keyword suggestion items. - **keyword** (string) - The suggested keyword. - **location_code** (integer) - The location code. - **search_volume** (integer) - The monthly search volume for the keyword. - **competition** (float) - The competition level for the keyword. - **cpc** (float) - The average cost per click for the keyword. - **keyword_difficulty** (integer) - The estimated keyword difficulty. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "keyword": "seo tools", "location_code": 2840, "search_volume": 18100, "competition": 0.85, "cpc": 12.45, "keyword_difficulty": 67 } ] } ] } ``` ``` -------------------------------- ### Reputation Management API Source: https://context7.com/context7/dataforseo_api-docs/llms.txt Track and analyze online reviews, ratings, and mentions across various platforms. Monitor brand reputation, sentiment analysis, competitor reviews, and review response rates. ```APIDOC ## POST /v3/business_data/google/reviews/task_post ### Description Initiates a task to retrieve reviews from Google Business Profile. ### Method POST ### Endpoint https://api.dataforseo.com/v3/business_data/google/reviews/task_post ### Parameters #### Request Body - **keyword** (string) - Required - The business name or keyword to search for. - **location_code** (integer) - Required - The location code for the search. - **language_code** (string) - Required - The language code for the search. - **depth** (integer) - Optional - The number of reviews to retrieve. Defaults to 100. ### Request Example ```json [ { "keyword": "DataForSEO", "location_code": 2840, "language_code": "en", "depth": 100 } ] ``` ## POST /v3/business_data/yelp/reviews/task_post ### Description Initiates a task to retrieve reviews from Yelp. ### Method POST ### Endpoint https://api.dataforseo.com/v3/business_data/yelp/reviews/task_post ### Parameters #### Request Body - **url** (string) - Required - The URL of the Yelp business page. - **depth** (integer) - Optional - The number of reviews to retrieve. Defaults to 50. ### Request Example ```json [ { "url": "https://www.yelp.com/biz/business-name", "depth": 50 } ] ``` ### Response #### Success Response (20000) - **tasks** (array) - An array containing task results. - **result** (array) - An array of business data. - **title** (string) - The name of the business. - **rating** (object) - The average rating and number of votes. - **value** (float) - The average rating value. - **votes_count** (integer) - The total number of votes. - **reviews** (array) - An array of individual reviews. - **review_text** (string) - The text of the review. - **rating** (integer) - The rating given in the review. - **timestamp** (string) - The date and time the review was posted. #### Response Example ```json { "status_code": 20000, "tasks": [ { "result": [ { "title": "Company Name", "rating": { "value": 4.5, "votes_count": 156 }, "reviews": [ { "review_text": "Great service!", "rating": 5, "timestamp": "2025-09-15" } ] } ] } ] } ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.