Real-Time Web Search SERP & Related Keywords API

Parameters

• qstringrequired

  Search query string (supports search operators such as site:, filetype:, intitle:, and exact quotes). Aliases: query, keyword.

  Example: ceramic mug

• countrystring

  Two-letter ISO 3166-1 alpha-2 country code for geo-localized SERP rankings (e.g., us, gb, de, jp, br). Alias: gl.

  Example: us

• langstring

  ISO 639-1 interface & result language code (e.g., en, es, de, fr, ja). Alias: hl.

  Example: en

• limitinteger (1 to 100)

  Number of organic results to return (1 to 100, default 10). Alias: num.

  Example: 10

• offsetinteger

  Zero-based pagination offset (0, 10, 20...). Alias: start.

  Example: 0

• safestring

  SafeSearch filter mode (off or active).

  Example: off

• freshstring

  Set fresh=1 to bypass the 6-hour SERP hot cache on paid plans.

Example Request (cURL / Python / JavaScript)

curl "https://api.searchdataapi.com/v1/search?q=ceramic+mug" \
  -H "x-api-key: sr_live_your_api_key"

import requests

res = requests.get(
    "https://api.searchdataapi.com/v1/search?q=ceramic+mug",
    headers={"x-api-key": "sr_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.searchdataapi.com/v1/search?q=ceramic+mug", {
  headers: { "x-api-key": "sr_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://searchdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "query": "ceramic mug",
    "country": "US",
    "lang": "en",
    "total_results_estimate": 87,
    "count": 3,
    "offset": 0,
    "has_more": true,
    "next_offset": 3,
    "organic_results": [
      {
        "position": 1,
        "title": "Buy Ceramic Cups, Coffee Cups & Travel Coffee Mugs | Nova Ceramics",
        "url": "https://novaceramics.co/collections/ceramic-cups",
        "domain": "novaceramics.co",
        "displayed_url": "novaceramics.co › collections › ceramic-cups",
        "snippet": "Shop handcrafted stoneware ceramic cups, coffee mugs, and travel coffee mugs at Nova Ceramics. Microwave and dishwasher safe artisan glazes.",
        "favicon": "https://www.google.com/s2/favicons?domain=novaceramics.co&sz=64",
        "published_at": null
      },
      {
        "position": 2,
        "title": "Ceramic Coffee Mugs & Mug Sets | Microwave Safe — Mora Ceramics",
        "url": "https://moraceramics.com/collections/mugs",
        "domain": "moraceramics.com",
        "displayed_url": "moraceramics.com › collections › mugs",
        "snippet": "Shop Mora Paladin clay ceramic coffee mugs and latte cups. Lead-free glaze, extra-strong stoneware, microwave safe, and dishwasher safe.",
        "favicon": "https://www.google.com/s2/favicons?domain=moraceramics.com&sz=64",
        "published_at": null
      },
      {
        "position": 3,
        "title": "Handmade Ceramic Mugs & Cups — Wolf Ceramics",
        "url": "https://wolfceramics.com/collections/mugs-cups",
        "domain": "wolfceramics.com",
        "displayed_url": "wolfceramics.com › collections › mugs-cups",
        "snippet": "Shop wheel-thrown handmade stoneware mugs and cups crafted by artisans in Hood River, Oregon. Built for daily pour-over and espresso rituals.",
        "favicon": "https://www.google.com/s2/favicons?domain=wolfceramics.com&sz=64",
        "published_at": null
      }
    ],
    "people_also_ask": [],
    "knowledge_graph": null,
    "related_keywords": [
      "ceramic mugs handmade",
      "ceramic coffee mugs",
      "stoneware ceramic mug",
      "ceramic travel mug with lid",
      "japanese ceramic mug",
      "large 16oz ceramic mug"
    ],
    "related_searches": [
      "ceramic mugs handmade",
      "ceramic coffee mugs",
      "stoneware ceramic mug",
      "ceramic travel mug with lid",
      "japanese ceramic mug",
      "large 16oz ceramic mug"
    ]
  },
  "meta": {
    "request_id": "f3b0cb6f-059c-4023-967b-e236e19c29ae",
    "endpoint": "/v1/search",
    "count": 3,
    "credits_charged": 2,
    "cached": false,
    "took_ms": 642
  }
}

Response Fields

Status Codes

200

Structured real-time SERP payload with direct organic URLs, native related_keywords, and PAA.