# SearchData API — Complete LLM & AI Agent Technical Reference (llms-full.txt) > Real-Time Google Search SERP + People Also Ask, 54-Week Google Trends Curves, Google Suggest Autocomplete, and Google News Live Wire API for AI Agents, LangChain RAG, and SEO Pipelines. > Base URL: `https://api.searchdataapi.com` | Main Website: `https://searchdataapi.com` > Remote MCP Server (Streamable HTTP): `https://mcp.searchdataapi.com/v1/mcp` | 1-Click OAuth 2.1 Connector: `https://mcp.searchdataapi.com/v1/mcp` > AI Skill Manifest: `https://searchdataapi.com/SKILL.md` | MCP Registry Manifest: `https://searchdataapi.com/server.json` > OpenAPI 3.1 Spec: `https://searchdataapi.com/openapi.json` | Compact Summary: `https://searchdataapi.com/llms.txt` ## 1. Authentication, Remote MCP & Core Architecture - **Base URL**: `https://api.searchdataapi.com` - **Authentication Header**: Pass either `Authorization: Bearer sr_live_your_api_key` OR `x-api-key: sr_live_your_api_key` on every request. - **1-Click Remote MCP & OAuth 2.1 (Claude Web, ChatGPT Connectors, Cursor)**: - 1-Click OAuth 2.1 DCR + PKCE `S256` Connector URL: `https://mcp.searchdataapi.com/v1/mcp` - API-Key Streamable HTTP Endpoint: `https://mcp.searchdataapi.com/v1/mcp` - **Free Trial & Sandbox Streak ($3.20 / 32,000 Total Free Credits)**: Every new account receives **$1.20 (12,000 Free Credits)** immediately upon sign-up at `https://searchdataapi.com/signup` with zero credit card, plus up to **+$2.00 (+20,000 Credits)** via the Developer Sandbox Streak. - **Zero Charge on Empty Searches & Errors**: Any query returning 0 results or 4xx/5xx upstream error costs **0 Credits**. ## 2. Pricing & Telemetry Credit System ($1 = 10,000 Credits) | Data Type / Endpoint | Credits | Base Rate | $9 Indie Pack | Scale ($199/mo) | | :--- | :--- | :--- | :--- | :--- | | Google Web SERP + PAA (`GET /v1/search`) | 2 Credits | $0.20 / 1K | $0.12 / 1K | $0.08 / 1K | | Realtime Trending Breakouts (`GET /v1/trends/realtime`) | 2 Credits | $0.20 / 1K | $0.12 / 1K | $0.08 / 1K | | 54-Week Trends Interest Curve (`GET /v1/trends/interest`) | 10 Credits | $1.00 / 1K | $0.60 / 1K | $0.40 / 1K | | Google News Search & Top (`/v1/news/search`, `/v1/news/top`) | 2 Credits | $0.20 / 1K | $0.12 / 1K | $0.08 / 1K | | Google Suggest Autocomplete (`GET /v1/autocomplete`) | 1 Credit | $0.10 / 1K | $0.06 / 1K | $0.04 / 1K | ## 3. Complete Endpoint Reference & Code Samples ### Real-Time Web Search SERP & Related Keywords API (`GET /v1/search`) - **Documentation URL**: https://searchdataapi.com/docs/search - **Cost**: 2 Credits / query (0 if empty) ($0.0002 / query ($0.11–$0.20 / 1K queries)) - **Description**: Execute a real-time web search query localized by country and language. Returns up to 100 structured canonical organic rankings per call (position, title, direct URL, domain, displayed breadcrumb, favicon, snippet), native cleaned & deduplicated `related_keywords` array (`[]` when none), People Also Ask accordions, and Knowledge Graph cards for AI agents, RAG grounding, and SEO keyword/rank intelligence. - **Parameters**: - `q` (query, required): Search query string (supports search operators such as site:, filetype:, intitle:, and exact quotes). Aliases: query, keyword. [example: `ceramic mug`] - `country` (query, optional): 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`] - `lang` (query, optional): ISO 639-1 interface & result language code (e.g., en, es, de, fr, ja). Alias: hl. [example: `en`] - `limit` (query, optional): Number of organic results to return (1 to 100, default 10). Alias: num. [example: `10`] - `offset` (query, optional): Zero-based pagination offset (0, 10, 20...). Alias: start. [example: `0`] - `safe` (query, optional): SafeSearch filter mode (off or active). [example: `off`] - `fresh` (query, optional): Set fresh=1 to bypass the 6-hour SERP hot cache on paid plans. ```bash curl "https://api.searchdataapi.com/v1/search?q=ceramic+mug" \ -H "x-api-key: sr_live_your_api_key" ``` ```python 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()) ``` --- ### Real-Time Trending Searches & Breakout Velocity API (`GET /v1/trends/realtime`) - **Documentation URL**: https://searchdataapi.com/docs/trends-realtime - **Cost**: 2 Credits / query (0 if empty) ($0.0002 / query ($0.11–$0.20 / 1K queries)) - **Description**: Fetch currently surging daily and real-time trending search queries for any country, including approximate search volume tiers (e.g., 200K+, 500K+), breakout status, publication timestamps, and linked news context. - **Parameters**: - `country` (query, optional): Two-letter ISO country code (e.g., US, GB, CA, DE, JP, IN, BR). Alias: geo. [example: `US`] - `category` (query, optional): Optional trend category filter (all, business, technology, entertainment, sports, science, health). [example: `all`] - `limit` (query, optional): Maximum number of trending items to return (1 to 100, default 25). [example: `20`] ```bash curl "https://api.searchdataapi.com/v1/trends/realtime" \ -H "x-api-key: sr_live_your_api_key" ``` ```python import requests res = requests.get( "https://api.searchdataapi.com/v1/trends/realtime", headers={"x-api-key": "sr_live_your_api_key"}, timeout=30, ) print(res.json()) ``` --- ### 54-Week Historical Search Interest Over Time Curve API (`GET /v1/trends/interest`) - **Documentation URL**: https://searchdataapi.com/docs/trends-interest - **Cost**: 10 Credits / 54-week curve (0 if empty) ($0.001 / curve ($0.55–$1.00 / 1K curves)) - **Description**: Retrieve the 52–54 week normalized (0–100) search interest time-series curve for one or up to 5 comma-separated keywords, complete with peak week, current index, average score, momentum delta %, and breakout classification. - **Parameters**: - `keyword` (query, required): Target keyword or comma-separated list of up to 5 keywords to compare (e.g., 'artificial intelligence' or 'langchain,llamaindex'). Alias: q. [example: `artificial intelligence`] - `country` (query, optional): Two-letter ISO country code for regional trend telemetry (e.g., US, GB, DE, JP). [example: `US`] - `lang` (query, optional): ISO 639-1 language code (default en). [example: `en`] ```bash curl "https://api.searchdataapi.com/v1/trends/interest?keyword=artificial+intelligence" \ -H "x-api-key: sr_live_your_api_key" ``` ```python import requests res = requests.get( "https://api.searchdataapi.com/v1/trends/interest?keyword=artificial+intelligence", headers={"x-api-key": "sr_live_your_api_key"}, timeout=30, ) print(res.json()) ``` --- ### Real-Time News Search & Media Monitoring API (`GET /v1/news/search`) - **Documentation URL**: https://searchdataapi.com/docs/news-search - **Cost**: 2 Credits / query (0 if empty) ($0.0002 / query ($0.11–$0.20 / 1K queries)) - **Description**: Search breaking global news articles by keyword, company, ticker, or topic with optional recency window filtering (1h, 24h, 7d, 30d, 1y). Returns article title, canonical URL, snippet, UTC publication timestamp, thumbnail image, authors, and publisher domain/favicon. - **Parameters**: - `q` (query, required): News search query (company name, person, market event, or boolean phrase). [example: `electric vehicles`] - `country` (query, optional): Two-letter ISO edition country code (default US). [example: `US`] - `lang` (query, optional): ISO 639-1 language code (default en). [example: `en`] - `when` (query, optional): Optional freshness window (1h, 1d, 7d, 30d, 1y). [example: `7d`] - `limit` (query, optional): Maximum number of news articles to return (1 to 100, default 20). [example: `20`] ```bash curl "https://api.searchdataapi.com/v1/news/search?q=electric+vehicles" \ -H "x-api-key: sr_live_your_api_key" ``` ```python import requests res = requests.get( "https://api.searchdataapi.com/v1/news/search?q=electric+vehicles", headers={"x-api-key": "sr_live_your_api_key"}, timeout=30, ) print(res.json()) ``` --- ### Live Top Headlines by Topic & Country API (`GET /v1/news/top`) - **Documentation URL**: https://searchdataapi.com/docs/news-top - **Cost**: 2 Credits / query (0 if empty) ($0.0002 / query ($0.11–$0.20 / 1K queries)) - **Description**: Stream top breaking headlines across 9 standardized topic feeds (TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH) for any country and language. - **Parameters**: - `topic` (query, optional): Headline topic feed (TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH). [example: `TECHNOLOGY`] - `country` (query, optional): Two-letter ISO country code (default US). [example: `US`] - `lang` (query, optional): ISO 639-1 language code (default en). [example: `en`] - `limit` (query, optional): Maximum number of headlines to return (1 to 100, default 20). [example: `20`] ```bash curl "https://api.searchdataapi.com/v1/news/top" \ -H "x-api-key: sr_live_your_api_key" ``` ```python import requests res = requests.get( "https://api.searchdataapi.com/v1/news/top", headers={"x-api-key": "sr_live_your_api_key"}, timeout=30, ) print(res.json()) ``` --- ### Sub-80ms Search Suggest & Typeahead Autocomplete API (`GET /v1/autocomplete`) - **Documentation URL**: https://searchdataapi.com/docs/autocomplete - **Cost**: 1 Credit / query (0 if empty) ($0.0001 / query ($0.06–$0.10 / 1K queries)) - **Description**: Return real-time search query completions for any seed prefix, country, and language in under 80ms. Ideal for programmatic SEO long-tail discovery, e-commerce search boxes, and LLM RAG query fan-out. - **Parameters**: - `q` (query, required): Seed query prefix to expand (e.g., 'best crm for' or 'how to migrate from'). [example: `best crm for`] - `country` (query, optional): Two-letter ISO country code (default us). [example: `us`] - `lang` (query, optional): ISO 639-1 language code (default en). [example: `en`] - `limit` (query, optional): Maximum number of autocomplete suggestions to return (1 to 20, default 10). [example: `10`] ```bash curl "https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for" \ -H "x-api-key: sr_live_your_api_key" ``` ```python import requests res = requests.get( "https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for", headers={"x-api-key": "sr_live_your_api_key"}, timeout=30, ) print(res.json()) ``` ## 4. Engineering Guides & Architecture Blueprints ### SerpApi Pricing Breakdown (2026): Why $75/mo Equals $15.00/1K & How to Cut Costs 15x–75x - **URL**: https://searchdataapi.com/guides/serpapi-pricing - **Summary**: Line-by-line 2026 SerpApi pricing audit: Developer ($75/mo = $15/1K), Production ($150/mo = $10/1K), monthly credit expiry, and migrating to SearchData API at $0.08–$0.20/1K. - **Key Takeaways**: - SerpApi's $75/month Developer plan works out to $15.00 per 1,000 searches — 75x higher than SearchData API's $0.20/1K base rate and 187x higher than our $0.08/1K Scale tier. - Unused SerpApi monthly searches expire every 30 days, whereas SearchData API Pay-As-You-Go packs (starting at $9 for 75,000 credits = 37,500 SERP queries) never expire. - AI agents using multi-step query decomposition (3–5 Google searches + 1 News lookup per prompt) burn $0.06–$0.09 per prompt on SerpApi vs $0.0006 on SearchData API. - Switching takes under 5 minutes: swap https://serpapi.com/search for https://api.searchdataapi.com/v1/search with an sr_live_ Bearer key. ### Google Trends API Guide (2026): Query Realtime Breakouts & 54-Week Curves Without HTTP 429s - **URL**: https://searchdataapi.com/guides/google-trends-api-guide - **Summary**: Query Google Trends realtime surging topics ($0.20/1K) and 54-week 0–100 interest-over-time curves ($1.00/1K) via REST & Python without pytrends 429 blocks or proxies. - **Key Takeaways**: - pytrends was archived in 2025 and triggers immediate HTTP 429 / cookie token challenges from datacenter subnets. - GET /v1/trends/realtime streams daily & realtime trending topics, traffic volume tiers (e.g., 200K+, +450%), and linked news articles for 2 Credits ($0.20/1K). - GET /v1/trends/interest returns 52–54 weekly 0–100 data points, peak index, velocity delta, and rising/top related queries for 10 Credits ($1.00/1K base, $0.40/1K on Scale). - Built-in PostgreSQL + Redis sr: caching serves repeated trend lookups in <35ms. ### Best Google News API & NewsAPI.org Alternative in 2026 ($0.20/1K Commercial Ready) - **URL**: https://searchdataapi.com/guides/google-news-api-alternative - **Summary**: Replace NewsAPI.org's $449/mo Business plan and 24h free-tier delay with real-time Google News search (/v1/news/search) and topic headlines (/v1/news/top) at $0.08–$0.20/1K. - **Key Takeaways**: - NewsAPI.org's Developer tier forbids commercial production apps and delays articles by 24 hours; its Business tier starts at $449/month. - SearchData API streams live publisher articles, source favicons, ISO-8601 UTC timestamps, and snippets in real time from $0.08–$0.20/1K. - Dual-rail architecture pairs rich publisher metadata with automatic failover across 100+ country editions. - Start free with 12,000 credits ($1.20 = 6,000 news queries) or buy the $9 Indie Pack (37,500 news queries, never expires). ### Google Custom Search JSON API Alternative (2026): Cut $5/1K to $0.20/1K & Remove the 10K/Day Cap - **URL**: https://searchdataapi.com/guides/google-custom-search-api-alternative - **Summary**: Migrate from Google Custom Search JSON API ($5.00/1K + strict 10,000 queries/day hard limit) to SearchData API for true Google SERP rankings, PAA, and $0.08–$0.20/1K pricing. - **Key Takeaways**: - Google Custom Search JSON API costs $5.00 per 1,000 queries — 25x to 62x more expensive than SearchData API ($0.08–$0.20/1K). - Google CSE enforces a hard 10,000 queries/day limit on the standard JSON API, blocking high-concurrency RAG and SEO crawls. - Programmable Search Engine indices differ from consumer Google.com SERPs and strip People Also Ask (PAA) and rich Knowledge Graph cards. - Migrate in 5 minutes by mapping items[].title / link / snippet to organic_results[].title / url / snippet. ### Serper.dev vs SearchData API (2026): Pricing, $9 Indie Pack, 54-Week Trends & Remote MCP - **URL**: https://searchdataapi.com/guides/serper-vs-searchdataapi - **Summary**: Compare Serper.dev ($50 min top-up, 6-month credit expiry, no 54-week Trends) vs SearchData API ($9 never-expiring Indie Pack, $0.08–$0.20/1K, 54-week Google Trends & Remote MCP). - **Key Takeaways**: - $9 vs $50 Minimum Top-Up: Ship indie AI tools with our $9 Indie Starter Pack (75,000 never-expiring credits) instead of a $50 upfront commitment. - Never-Expiring PAYG Credits: SearchData API PAYG credits never expire, whereas Serper credits expire after 6 months. - Built-In 54-Week Google Trends Telemetry: Query /v1/trends/realtime and /v1/trends/interest alongside /v1/search and /v1/news/* under one API key. - Hosted Remote MCP (mcp.searchdataapi.com): Connect Claude, Cursor, Windsurf, and ChatGPT directly without running local Python/Node stdio wrappers. ### Real-Time Web Search & News Grounding for LangChain, LlamaIndex & MCP Agents (2026) - **URL**: https://searchdataapi.com/guides/langchain-rag-web-search-api - **Summary**: Ground LLMs and autonomous AI agents with live Google SERP snippets, People Also Ask, and breaking news wires at $0.08–$0.20/1K via REST or Remote MCP. - **Key Takeaways**: - Costs $0.00008–$0.0002 per tool invocation — allowing deep research agents to run 10 parallel queries for less than a fifth of a cent. - Returns clean plain-text snippets and People Also Ask Q&A pairs ready for prompt injection without HTML DOM stripping. - Zero-install Remote MCP server (https://mcp.searchdataapi.com/mcp) exposes all 6 search, trends, news, and autocomplete tools to Claude, Cursor, and Windsurf. - Combine /v1/autocomplete for query fan-out with /v1/search and /v1/news/search for hybrid web + recency retrieval. ### How to Fix pytrends HTTP 429 Too Many Requests in Python (2026) - **URL**: https://searchdataapi.com/guides/pytrends-429-too-many-requests-fix - **Summary**: Fix pytrends ResponseError Google returned a response with code 429 in Python: 3 native workarounds vs zero-429 GET /v1/trends JSON API ($0.20/1K). - **Key Takeaways**: - Cloud ASNs (AWS EC2/Lambda, Hetzner, GCP, DigitalOcean, GitHub Actions) hit HTTP 429 on the very first trends.google.com/trends/api/explore token handshake. - Passing retries=3, backoff_factor=0.5 in pytrends 4.9.2 raises TypeError: Retry.__init__() got an unexpected keyword argument 'method_whitelist' on urllib3 >= 2.0. - Manual NID browser cookies expire or rotate within ~15–25 sequential keyword lookups, breaking unattended cron pipelines. - SearchData API (GET /v1/trends & GET /v1/trends/realtime) delivers 54-week 0–100 timelines and live trending breakouts from $0.20/1K calls with 0% 429 rate and 0 charge on empty responses. ## 5. Competitor Benchmarks ### SearchData API vs SerpApi (serpapi.com) - **URL**: https://searchdataapi.com/compare/serpapi-alternative - **Headline**: $0.08–$0.20 vs $15.00 per 1,000 Google SERP queries - **Summary**: SerpApi starts at $75/month for 5,000 searches ($15.00/1K) and expires unused monthly credits every 30 days. SearchData API delivers Google SERP + PAA, 54-week Trends curves, Autocomplete, and Google News from $0.08–$0.20/1K with a $9 never-expiring Indie Pack. ### SearchData API vs Serper.dev (serper.dev) - **URL**: https://searchdataapi.com/compare/serper-alternative - **Headline**: $0.08–$0.12 vs $0.30–$1.00 per 1,000 queries + 54w Trends - **Summary**: Serper.dev requires a $50 minimum top-up that expires in 6 months and offers no Google Trends timeline API. SearchData API starts free ($1.20), unlocks 37,500 SERP calls for $9 (never expires), scales to $0.08/1K, and adds 54-week Google Trends + Remote MCP. ### SearchData API vs Google Custom Search (developers.google.com/custom-search) - **URL**: https://searchdataapi.com/compare/google-custom-search-alternative - **Headline**: $0.20 vs $5.00 per 1,000 Google searches - **Summary**: Google Custom Search JSON API bills $5.00 per 1,000 queries, hard-stops at 10,000 queries/day, and returns Programmable Search Engine subsets without People Also Ask. SearchData API delivers real Google.com SERPs at $0.08–$0.20/1K. ### SearchData API vs NewsAPI.org (newsapi.org) - **URL**: https://searchdataapi.com/compare/newsapi-alternative - **Headline**: $0.20 vs $449/mo for live commercial news feeds - **Summary**: NewsAPI.org restricts its free tier to non-commercial localhost development with a 24-hour article delay, then charges $449/month for Business. SearchData API streams live Google News search & topic headlines commercially from $0.08–$0.20/1K. ## 6. Frequently Asked Questions ### How does the $1.00 = 10,000 Credits ($0.20 / 1K Queries) pricing model work? SearchData API uses a transparent credit ledger where $1.00 = 10,000 Credits. Standard real-time Web Search SERP (/v1/search), News Search (/v1/news/search), Top Headlines (/v1/news/top), and Realtime Trends (/v1/trends/realtime) cost 2 Credits per query ($0.20 per 1,000 queries on PAYG, $0.11/1K on Pro $69/mo, and $0.08/1K on Business $199/mo). Sub-80ms Autocomplete (/v1/autocomplete) costs 1 Credit ($0.10/1K base, $0.04/1K on Business), and 54-week historical Search Interest curves (/v1/trends/interest) cost 10 Credits ($0.001). Empty results or failed calls always cost 0 Credits. ### How is SearchData API 15x to 75x cheaper than SerpApi ($75/month)? SerpApi's entry Developer plan requires a $75/month recurring commitment for 5,000 searches ($15.00 per 1,000 queries), and unused monthly searches expire. SearchData API eliminates residential browser-rendering bloat via a multi-rail JSON gateway backed by L1 Redis + PostgreSQL 16 write-through caching: PAYG packs start at just $9 (75,000 never-expiring credits = 37,500 SERP queries) or $25 ($0.20/1K), while monthly plans lower your effective cost to $0.08–$0.15 per 1,000 queries. ### Can I connect SearchData API directly to LangChain, LlamaIndex, Claude Desktop, or Cursor? Yes. Every response returns deterministic, LLM-ready JSON (organic rankings, highlighted snippets, People Also Ask Q&A, 54-week trend curves, and news articles) with zero HTML parsing required. You can connect Claude, ChatGPT, Cursor, or Windsurf in 30 seconds via our Remote OAuth 2.1 MCP Server (https://mcp.searchdataapi.com/v1/mcp) or npx @searchdataapi/mcp-server. ### What is the response latency across Web Search SERP, Trends, News, and Autocomplete? Autocomplete (/v1/autocomplete) responds in 35–80 ms live. Warm edge-cached SERP, News, and 54-week Trends queries respond in 15–35 ms. Cold live pass-through queries complete in 180 ms – 2.4 s across our multi-rail global search cluster with automatic failover and 99.95% uptime SLA. ### Can I migrate from SerpApi, Serper.dev, Google Custom Search JSON API, or NewsAPI in minutes? Yes. In addition to our clean /v1/* endpoints, our gateway supports drop-in route and parameter aliases (/search.json, /customsearch/v1, /v2/everything, /v2/top-headlines, POST /v1/search with gl/hl/num) so you can swap your base URL to https://api.searchdataapi.com and pass x-api-key: sr_live_.... ### Am I charged when a query returns 0 results or when an upstream request fails? Never. SearchData API enforces strict Charge-Before-Return & Zero-Charge-on-Error accounting: queries returning 0 items, HTTP 400 validation errors, HTTP 429 rate limits, and HTTP 5xx upstream errors deduct 0 Credits. ### Should I choose the $9 Indie Starter / PAYG Pack or a Monthly Subscription? PAYG Credit Packs ($9 Indie Starter / 75K credits, $25 / 250K, $89 / 1.2M, $249 / 5M) have zero recurring fees and purchased credits never expire—ideal for burst scraping, prototypes, and AI side projects. Monthly subscriptions ($19 Starter / 250K, $69 Pro / 1.2M, $199 Business / 5M) include +31% to +151% bonus credits, dropping SERP cost to $0.08–$0.15 per 1,000 queries. ### What are the RPM rate limits and concurrency tiers? Free Trial accounts include 12,000 Credits ($1.20 instant + $2.00 Sandbox Streak) and 30 RPM (2 RPS). Paid tiers unlock burst-smoothed production concurrency: 120 RPM / 5 RPS ($9 Indie & $19 Starter), 300 RPM / 10 RPS ($69 Pro), and 600 RPM / 15 RPS ($199 Business). Need 1,000+ RPM? Dedicated Enterprise Key Pools are available via support@searchdataapi.com. ### What payment methods and invoices are supported? We support dual-rail checkout: Credit/Debit Cards, Apple Pay & Google Pay via Stripe (with downloadable VAT/Tax PDF invoices) AND 0%-fee Cryptocurrency (USDT, USDC, SOL, BTC, BNB across Solana, Arbitrum, Polygon, Base/BSC, Tron, and Ethereum) via NOWPayments with an automatic +5% Bonus Credits reward. ### What is your refund policy? Payments made within the last 14 days are eligible for a pro-rated refund of unused purchased credits. Promotional signup and streak credits have no cash value.