DataForSEO SERP APIInstall

Summary

Retrieve detailed, structured Google Organic SERP data for a specified keyword, location, and language with advanced options for device, OS, depth, and additional query parameters.

Inputs

• Keyword (required) — The keyword to search for on Google Organic SERP, supporting up to 700 characters with percent-encoding for special characters.
• Location (required) — The full name of the search engine location to target the SERP results to.
• Language (required) — The full name of the search engine language to use for the query.
• Task Priority — Set the execution priority of the task, either Normal or High.
• GPS Coordinates of a Location — Optional latitude, longitude, and radius to specify a location with format 'latitude,longitude,radius'.
• Device — Device type to emulate for the search results; Desktop or Mobile.
• OS — Operating system of the device making the request; Windows, macOS for desktop, Android, or iOS for mobile.
• Search Engine Domain — Custom Google search engine domain to use instead of the default domain inferred from location and language.
• Depth — Number of search results depth to retrieve, between 1 and 700 results, default is 100.
• Direct URL of the Search Query — Specify a direct URL for the search query to extract relevant parameters automatically.
• Display Related Results? — Boolean to indicate whether to show related results snippets within parent organic results.
• Page Crawl Limit — Maximum pages to crawl for results, between 1 and 100 if specified.
• Additional Parameters of the Search Query — Extra parameters as a string to customize the search query.
• Calculate Pixel Rankings for SERP Elements in Advanced Results? — Boolean indicating whether to calculate pixel-based rankings for SERP elements in the advanced response.
• Browser Screen Width — Width in pixels of the browser screen to emulate for the search.
• Browser Screen Height — Height in pixels of the browser screen to emulate for the search.
• Browser Screen Resolution Ratio — Screen resolution ratio (between 1 and 3) to emulate for the browser.
• Clicks on the Corresponding Element — Number of clicks depth (1 to 4) on 'People also ask' elements to simulate.
• Load Asynchronous AI Overview — Boolean to fetch AI overview components even if loaded asynchronously in the SERP.
• Expand AI Overview? — Boolean to expand AI overview elements in the response.
• Remove Specific Parameters From URLs — List of URL parameters (up to 10) to remove from URLs returned in the results.

Output shape

a detailed JSON object representing the advanced Google Organic SERP data for the keyword and parameters specified

The returned data includes a comprehensive structure of organic results with optional related results, AI overview, pixel rankings, and metadata, depending on parameters. Pagination is controlled by depth and crawl pages parameters. Errors and rate limits are handled by the DataForSEO service.

Examples

Example 1: Retrieve organic SERP for 'coffee maker' in New York, English, desktop on Windows with Normal priority and maximum 50 results.

Keyword='coffee maker', location_name='New York', language_name='English', device='desktop', os='windows', priority=1, depth=50

Links

• n8n community nodes installation guide