Search Dataset

📊

Historical Data Availability

Historical data available from January 2023. Access depends on your subscription plan.

What You Can Track

• Keyword Metrics: Search volume, CPC, and difficulty scores
• Website Keywords: Click metrics from search results for specific keywords leading to website visits
• Zero-Click Analysis: Understanding searches that don't result in clicks
• SERP Features: Tracking which features appear for keywords
• Device-Specific Data: Desktop vs mobile keyword performance
• Competitive Positioning: URLs and positions for organic and paid results

📘

API Key Requirements

Batch API and REST API use different authentication keys. Ensure you're using your Batch API key for these requests.

🔍

Granularity Consistency

When generating a report, make sure all metrics are supported by the same granularity as the requested report.

Getting Started

1. Authentication

Include your Batch API key in the request headers:

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--request POST \
--data body

2. Request Structure

All Search Dataset requests follow this structure:

Available Tables (vtables)

Keywords (keywords)

Primary Use Case: Provides comprehensive keyword metrics including search volume, CPC, difficulty scores, and zero-click analysis.

Primary Keys: keywords, countries

Available Metrics:

Example Request

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "delivery_information": {
    "response_format": "csv",
    "delivery_method_params": {
      "retention_days": 60
    }
  },
  "report_query": {
    "tables": [
      {
        "vtable": "keywords",
        "granularity": "monthly",
        "filters": {
          "countries": ["WW", "US"]
        },
        "metrics": [
          "all_keyword_cpc",
	  "keyword_search_volume",
          "desktop_keyword_difficulty",
          "zero_clicks_latest_serp_date",
          "zero_clicks_share"
        ],
        "start_date": "2025-06",
        "end_date": "2025-06"
      }
    ]
  }
}'

Website Search / Keywords Table (website_search_keywords)

Primary use case: Click metrics from search results for specific keywords leading to website visits.

Primary Keys: domains, keywords, countries

Available Metrics:

Example Request

curl --location 'https://api.similarweb.com/batch/v4/request-report' \
--header 'api-key: {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "delivery_information": {
    "response_format": "csv",
    "delivery_method_params": {
      "retention_days": 60
    }
  },
  "report_query": {
    "tables": [
      {
        "vtable": "website_search_keywords",
        "granularity": "monthly",
        "filters": {
          "countries": ["WW"],
          "include_subdomains": true
        },
        "metrics": [
          "organic_desktop_site_clicks",
          "organic_mobile_site_clicks",
          "paid_desktop_site_clicks",
          "paid_mobile_site_clicks"
        ],
        "start_date": "2025-07",
        "end_date": "2025-07"
      }
    ]
  }
}'

REST API Endpoints via Batch API

You can now access certain REST API endpoints through Batch API with specific limitations. This allows you to leverage Batch API's asynchronous processing capabilities for REST endpoints.

Limitations

• Supported granularities: daily, monthly
• Up to 100 keywords per request

Available Keyword Analysis Endpoints

The following REST API endpoints can be used via Batch API:

• SERP Players
• Keywords Overview