Serpstat icon

Serpstat

Search marketing and AI data with Serpstat API

Actions85

SERP Crawling → Add SERP Crawling Task

AI-generated

Overview

This node operation adds a SERP (Search Engine Results Page) crawling task to the Serpstat API. It allows users to submit a list of keywords to crawl regular or local Google search results, specifying parameters such as search engine, country, device type, language, number of pages to parse, region, and result type. This is useful for SEO professionals and marketers who want to gather detailed SERP data for keyword analysis and competitive research.

Use Case Examples

  1. Add a task to crawl Google SERP for keywords 'iphone, pizza' in the USA (country ID 23) for desktop devices, parsing 3 pages of results.
  2. Submit a local pack SERP crawling task for mobile devices in a specific region with a custom language setting.

Properties

Name Meaning
Search Engine The search engine to crawl. Only Google is currently supported.
Keywords Comma-separated list of keywords to crawl. Example: 'iphone, pizza'.
Country ID Numeric country identifier to specify the country for the search results (e.g., 23 for USA).
Additional Fields Optional parameters to customize the crawling task, including device type, language ID, number of SERP pages to parse, region ID, and results type.

Output

JSON

  • success - Indicates whether the task was successfully added.
  • taskId - Unique identifier of the created SERP crawling task.
  • message - Additional message or information returned by the API.

Dependencies

  • Serpstat API
  • An API key credential for Serpstat API authentication

Troubleshooting

  • Ensure the keywords parameter is a non-empty comma-separated string.
  • Verify the country ID is valid and supported by the Serpstat API.
  • Check that the API key credential is correctly configured and has permissions for SERP crawling tasks.
  • Handle API errors gracefully, as the node throws errors if the API response does not contain expected data.
  • If the task creation fails, review the error message returned by the Serpstat API for specific issues.

Links

Discussion