{ "openapi": "3.1.0", "info": { "title": "SearchData API — Real-Time Web Search SERP, Trends, News & Autocomplete REST Specification", "version": "1.0.0", "description": "High-throughput REST & MCP API for real-time web search SERP (direct canonical organic URLs, native `related_keywords`, People Also Ask, Knowledge Graph), live trending searches, 54-week historical search interest curves (0–100 telemetry), real-time news search & topic headlines, and sub-80ms typeahead autocomplete. Unified credit billing ($1.00 = 10,000 Credits, from $0.20 per 1,000 SERP/News queries; 0 Credits on empty or failed calls).\n\n**Rate Limits & Concurrency**: Free Trial `30 RPM (2 RPS)` · Indie Starter ($9 PAYG) & Starter ($19/mo or $25 PAYG) `120 RPM (5 RPS)` · Pro ($69/mo or $89 PAYG) `300 RPM (10 RPS)` · Business ($199/mo or $249 PAYG) `600 RPM (15 RPS)`. Need 1,000+ RPM? Dedicated Enterprise Key Pool available (`support@searchdataapi.com`).\n\n**Smart Caching & Live Refresh**: Web search SERPs and 54-week historical interest curves cache for `6h`; news and autocomplete streams cache for `2h`; realtime trends cache for `1h` (`?fresh=1` bypasses cache on paid plans)." }, "servers": [ { "url": "https://api.searchdataapi.com", "description": "Production Global Edge API Gateway" } ], "tags": [ { "name": "Web Search & SERP", "description": "Real-time organic search rankings, snippets, People Also Ask Q&A, Knowledge Graph entities, and related searches across 195 countries." }, { "name": "Search Trends & Velocity", "description": "Real-time daily trending breakout queries and 54-week historical search interest curves (normalized 0–100 scale)." }, { "name": "Real-Time News Wire", "description": "Keyword news search with freshness filters and live topic headlines (TECHNOLOGY, BUSINESS, WORLD, SCIENCE, HEALTH, SPORTS)." }, { "name": "Typeahead Autocomplete", "description": "Ultra-low-latency (<80ms) search query completions for keyword research, programmatic SEO, and RAG query expansion." } ], "paths": { "/v1/search": { "get": { "operationId": "v1_search", "summary": "Real-Time Web Search SERP & Related Keywords API", "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.", "tags": [ "Web Search & SERP" ], "x-credits-per-request": "2 Credits / query (0 if empty)", "x-price-per-request": "$0.0002 / query ($0.11–$0.20 / 1K queries)", "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search query string (supports search operators such as site:, filetype:, intitle:, and exact quotes). Aliases: query, keyword.", "example": "ceramic mug", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "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", "schema": { "type": "string", "default": "us" } }, { "name": "lang", "in": "query", "required": false, "description": "ISO 639-1 interface & result language code (e.g., en, es, de, fr, ja). Alias: hl.", "example": "en", "schema": { "type": "string", "default": "en" } }, { "name": "limit", "in": "query", "required": false, "description": "Number of organic results to return (1 to 100, default 10). Alias: num.", "example": 10, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } }, { "name": "offset", "in": "query", "required": false, "description": "Zero-based pagination offset (0, 10, 20...). Alias: start.", "example": 0, "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "safe", "in": "query", "required": false, "description": "SafeSearch filter mode (off or active).", "example": "off", "schema": { "type": "string", "enum": [ "off", "active" ], "default": "off" } }, { "name": "fresh", "in": "query", "required": false, "description": "Set fresh=1 to bypass the 6-hour SERP hot cache on paid plans.", "schema": { "type": "string", "enum": [ "0", "1" ] } } ], "responses": { "200": { "description": "Structured real-time SERP payload with direct organic URLs, native related_keywords, and PAA.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" }, "example": { "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 } } } } } } } }, "/v1/trends/realtime": { "get": { "operationId": "v1_trends_realtime", "summary": "Real-Time Trending Searches & Breakout Velocity API", "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.", "tags": [ "Search Trends & Velocity" ], "x-credits-per-request": "2 Credits / query (0 if empty)", "x-price-per-request": "$0.0002 / query ($0.11–$0.20 / 1K queries)", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "Two-letter ISO country code (e.g., US, GB, CA, DE, JP, IN, BR). Alias: geo.", "example": "US", "schema": { "type": "string", "default": "US" } }, { "name": "category", "in": "query", "required": false, "description": "Optional trend category filter (all, business, technology, entertainment, sports, science, health).", "example": "all", "schema": { "type": "string", "default": "all" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of trending items to return (1 to 100, default 25).", "example": 20, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } } ], "responses": { "200": { "description": "Real-time trending search queries with volume estimates and news context.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendsRealtimeResponse" }, "example": { "code": 0, "provider": "https://searchdataapi.com", "status": "ok", "msg": "success", "data": { "country": "US", "category": "all", "count": 3, "updated_at": "2026-11-14T17:26:34.679Z", "trending_searches": [ { "rank": 1, "keyword": "kraken vs hurricanes", "approx_traffic": "1000+", "traffic_volume_min": 1000, "status": "rising", "published_at": "2026-11-14T17:10:00.000Z", "picture_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTSZ_ao45PhQYap2ST4Cd4fLRELROekvgt7G-koURmQI13Uti2pRZr2cc9dT14", "picture_source": "NHL.com", "related_news": [ { "title": "Preview: November 14 vs. Seattle", "snippet": "", "url": "https://www.nhl.com/hurricanes/news/preview-november-14-vs-seattle", "source": "NHL.com", "picture_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTSZ_ao45PhQYap2ST4Cd4fLRELROekvgt7G-koURmQI13Uti2pRZr2cc9dT14" }, { "title": "Sebastian Aho Goes Full Circle, Scoring On 10th Anniversary Of First Career Goal While In Finland", "snippet": "", "url": "https://sports.yahoo.com/articles/sebastian-aho-goes-full-circle-164457630.html", "source": "Yahoo Sports", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQDEwDCEnDLuXKJgGBZgqMsLrldEFwAqDtdOnwVLIClsg6cvaTThkWEOF5tNU4" }, { "title": "Global Series Game Two: Hurricanes vs Kraken—Preview, How to Watch, Game Thread", "snippet": "", "url": "https://www.canescountry.com/carolina-hurricanes-game-day-previews/54660/global-series-game-two-hurricanes-vs-kraken-preview-how-to-watch-game-thread", "source": "Canes Country", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhjDTMzbm7HaQycz3Zm1wMmEEvx_ZNWVvmLjvEiqzMonp5ZynjnkTWGAZY_Nw" } ] }, { "rank": 2, "keyword": "east carolina vs charlotte", "approx_traffic": "500+", "traffic_volume_min": 500, "status": "rising", "published_at": "2026-11-14T17:10:00.000Z", "picture_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRp2FtB-nX3CDZIg4SP8bGPhSXxJe5EONRotMtYZuSb0vuF7x8SNXQzlld7vS0", "picture_source": "247Sports", "related_news": [ { "title": "Final Picks, and Bold Predictions, for ECU’s Game Against Charlotte", "snippet": "", "url": "https://247sports.com/college/east-carolina/article/ecu-football-charlotte-final-picks-and-bold-predictions-for-game-292650404/", "source": "247Sports", "picture_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRp2FtB-nX3CDZIg4SP8bGPhSXxJe5EONRotMtYZuSb0vuF7x8SNXQzlld7vS0" }, { "title": "East Carolina vs Charlotte Prediction, Picks & Odds | 14 Nov 2026", "snippet": "", "url": "https://www.sportsgambler.com/betting-tips/ncaaf/east-carolina-pirates-vs-charlotte-49ers-prediction-odds-2026-11-14/", "source": "Sportsgambler", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTNYkVtY1dMuxwSfoNEZvddpY0Jwfe16N-15Zcx9mRR9bSr2Rug7jZHsjEMfo4" }, { "title": "Bonesville Pregame Show", "snippet": "", "url": "https://bonesville.net/2026/11/13/1114-2026_pregame-show_charlotte/", "source": "Bonesville", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSXClTKHqqcYJ2HEBuaKd3voiyhbIOw67RcIYziQxe_rmucSY3mdstub7rNW5w" } ] }, { "rank": 3, "keyword": "uab vs temple", "approx_traffic": "200+", "traffic_volume_min": 200, "status": "rising", "published_at": "2026-11-14T17:10:00.000Z", "picture_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRN5AzQ42Rgpdyq34chuHZGLI6fkJWQeNA_kKgXBxRI1bagB8QeXoreuyzRmzQ", "picture_source": "AL.com", "related_news": [ { "title": "Scouting report: What you need to know for UAB’s game at Temple", "snippet": "", "url": "https://www.al.com/sports/2026/11/scouting-report-what-you-need-to-know-for-uabs-game-at-temple.html", "source": "AL.com", "picture_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRN5AzQ42Rgpdyq34chuHZGLI6fkJWQeNA_kKgXBxRI1bagB8QeXoreuyzRmzQ" }, { "title": "Temple-UAB Gameday: Owls seek Senior Day redemption", "snippet": "", "url": "https://247sports.com/college/temple/article/temple-uab-gameday-owls-seek-senior-day-redemption-292659258/", "source": "247Sports", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8eugMDS2XqikDE-thcuCYzgVKZcSqpichFrv3J72hqRP3Xi0uHqhI24BMzZQ" }, { "title": "Temple Football Preview: Dragons’ Defense a Top 20 Unit", "snippet": "", "url": "https://phlsportsnow.com/temple-football-preview-dragons-defense-a-top-20-unit/", "source": "Philadelphia Sports Now", "picture_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcStA22bS1uuSwEE5dNcuOmMRLL-zHehvEvDYOTBiUkftTIgGFVE8X7q6yjxKMM" } ] } ] }, "meta": { "request_id": "21e548c7-869e-4aea-9cdb-581b4b7d1fc4", "endpoint": "/v1/trends/realtime", "count": 3, "credits_charged": 2, "cached": false, "took_ms": 162 } } } } } } } }, "/v1/trends/interest": { "get": { "operationId": "v1_trends_interest", "summary": "54-Week Historical Search Interest Over Time Curve API", "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.", "tags": [ "Search Trends & Velocity" ], "x-credits-per-request": "10 Credits / 54-week curve (0 if empty)", "x-price-per-request": "$0.001 / curve ($0.55–$1.00 / 1K curves)", "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "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", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "Two-letter ISO country code for regional trend telemetry (e.g., US, GB, DE, JP).", "example": "US", "schema": { "type": "string", "default": "US" } }, { "name": "lang", "in": "query", "required": false, "description": "ISO 639-1 language code (default en).", "example": "en", "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "54-week historical search interest timeline (0–100) and momentum summary.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrendsInterestResponse" }, "example": { "code": 0, "provider": "https://searchdataapi.com", "status": "ok", "msg": "success", "data": { "keyword": "artificial intelligence", "keywords": [ "artificial intelligence" ], "country": "US", "lang": "en", "weeks_count": 52, "summary": { "current_interest": 21, "peak_interest": 100, "peak_week": "2026-02-08", "average_interest": 53, "yoy_change_pct": -22, "trend_direction": "declining", "velocity_badge": "-22%" }, "timeline": [ { "date_from": "2026-08-16", "date_to": "2026-08-22", "timestamp": 1786838400, "value": 27 }, { "date_from": "2026-08-23", "date_to": "2026-08-29", "timestamp": 1787443200, "value": 23 }, { "date_from": "2026-08-30", "date_to": "2026-09-05", "timestamp": 1788048000, "value": 28 }, { "date_from": "2026-09-06", "date_to": "2026-09-12", "timestamp": 1788652800, "value": 32 }, { "date_from": "2026-09-13", "date_to": "2026-09-19", "timestamp": 1789257600, "value": 47 }, { "date_from": "2026-09-20", "date_to": "2026-09-26", "timestamp": 1789862400, "value": 32 }, { "date_from": "2026-09-27", "date_to": "2026-10-03", "timestamp": 1790467200, "value": 31 }, { "date_from": "2026-10-04", "date_to": "2026-10-10", "timestamp": 1791072000, "value": 27 }, { "date_from": "2026-10-11", "date_to": "2026-10-17", "timestamp": 1791676800, "value": 27 }, { "date_from": "2026-10-18", "date_to": "2026-10-24", "timestamp": 1792281600, "value": 30 }, { "date_from": "2026-10-25", "date_to": "2026-10-31", "timestamp": 1792886400, "value": 32 }, { "date_from": "2026-11-01", "date_to": "2026-11-07", "timestamp": 1793491200, "value": 21 } ] }, "meta": { "request_id": "a7818c66-f8b3-4977-b168-aaeca403fa1b", "endpoint": "/v1/trends/interest", "count": 52, "credits_charged": 10, "cached": false, "took_ms": 4164 } } } } } } } }, "/v1/news/search": { "get": { "operationId": "v1_news_search", "summary": "Real-Time News Search & Media Monitoring API", "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.", "tags": [ "Real-Time News Wire" ], "x-credits-per-request": "2 Credits / query (0 if empty)", "x-price-per-request": "$0.0002 / query ($0.11–$0.20 / 1K queries)", "parameters": [ { "name": "q", "in": "query", "required": true, "description": "News search query (company name, person, market event, or boolean phrase).", "example": "electric vehicles", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "Two-letter ISO edition country code (default US).", "example": "US", "schema": { "type": "string", "default": "US" } }, { "name": "lang", "in": "query", "required": false, "description": "ISO 639-1 language code (default en).", "example": "en", "schema": { "type": "string", "default": "en" } }, { "name": "when", "in": "query", "required": false, "description": "Optional freshness window (1h, 1d, 7d, 30d, 1y).", "example": "7d", "schema": { "type": "string", "enum": [ "1h", "1d", "7d", "30d", "1y" ] } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of news articles to return (1 to 100, default 20).", "example": 20, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Real-time news articles matching the search query.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsResponse" }, "example": { "code": 0, "provider": "https://searchdataapi.com", "status": "ok", "msg": "success", "data": { "query": "electric vehicles", "country": "US", "lang": "en", "count": 3, "articles": [ { "position": 1, "title": "Volkswagen may have just hinted at the name of its next affordable EV", "url": "https://news.google.com/rss/articles/CBMiggFBVV95cUxOdm5WZW54RUs0dkZrdnRzSFhaWDBXRGl5OHVKZFJiWi0xNFR2ek5kaklCanJ6dHYyMWk3ZlNtd1ZoNmhZbU1TTWhVZ0ctRTl0TDZabTBtUDUwekl2TFhDZHhxNTVlRk9xMmwtdi1keVZJdHViVUJlSVEwS3RsOTZldHdR?oc=5", "snippet": "Volkswagen may have just hinted at the name of its next affordable EV    Electrek", "published_at": "2026-11-13T22:14:00.000Z", "image_url": null, "authors": [], "source": { "name": "Electrek", "url": "https://electrek.co", "domain": "electrek.co", "favicon": "https://www.google.com/s2/favicons?domain=electrek.co&sz=64" } }, { "position": 2, "title": "The Death of the Cybertruck Is Actually Great News for the Electric Vehicle Market", "url": "https://news.google.com/rss/articles/CBMi1wFBVV95cUxQSFNlTDhSVzhUSnJtdExvZ2xFLVFxU1c3ZHYyUEVNVzgyWTQ4c2I3STNjXzlVeks5a2FlWkJTYjFhMmNyYjVaY19Ba3Z6dzF2UnFwWnBSdlVBQ3RIWUhmVHRmTUlRNlIycDIyVEZVSnNSMmx6aVFpeVZOcU9KYUxfUkZuZHR6bEcyd2ZVTWxZYk5rblVmWkQ5b1IyMjI3dnUyVWpoRTNNcmlUR3RsT216eF9GYU1jR25qOUhFS0p5cW5XVWRzR0t0OUduQjZmMV9WeEdldXRVZw?oc=5", "snippet": "The Death of the Cybertruck Is Actually Great News for the Electric Vehicle Market    Mother Jones", "published_at": "2026-11-12T08:00:00.000Z", "image_url": null, "authors": [], "source": { "name": "Mother Jones", "url": "https://www.motherjones.com", "domain": "motherjones.com", "favicon": "https://www.google.com/s2/favicons?domain=motherjones.com&sz=64" } }, { "position": 3, "title": "2026 Jeep Recon vs. 2027 Rivian R2 Tested: Which Electric SUV Is Better?", "url": "https://news.google.com/rss/articles/CBMiswFBVV95cUxNeWJlWUs0OXJycnZoQ09OQlZxOTZFUjkyQ25WRWgxaER2QXhZamRxWExpaU02RC1ycUhyZWtwd0RfakVHR1JZODZLeGY4dFBvZkZrU01tSVZndDNSYnRfT3VxYW95RUY3a3hjNVJGcGRqbmFxaFFRZm5HNWFGYlZka1hteDhxZmNUVGZsVjhwV3pWc280WDBPZDJ4LVl6T0JFTVN1Y1VWUHJKbl9pZ3RwaWdMSQ?oc=5", "snippet": "2026 Jeep Recon vs. 2027 Rivian R2 Tested: Which Electric SUV Is Better?    Car and Driver", "published_at": "2026-11-13T15:06:21.000Z", "image_url": null, "authors": [], "source": { "name": "Car and Driver", "url": "https://www.caranddriver.com", "domain": "caranddriver.com", "favicon": "https://www.google.com/s2/favicons?domain=caranddriver.com&sz=64" } } ] }, "meta": { "request_id": "2efdbdff-2c00-4e16-8494-38e2afb7a9cd", "endpoint": "/v1/news/search", "count": 3, "credits_charged": 2, "cached": false, "took_ms": 1832 } } } } } } } }, "/v1/news/top": { "get": { "operationId": "v1_news_top", "summary": "Live Top Headlines by Topic & Country API", "description": "Stream top breaking headlines across 9 standardized topic feeds (TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH) for any country and language.", "tags": [ "Real-Time News Wire" ], "x-credits-per-request": "2 Credits / query (0 if empty)", "x-price-per-request": "$0.0002 / query ($0.11–$0.20 / 1K queries)", "parameters": [ { "name": "topic", "in": "query", "required": false, "description": "Headline topic feed (TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH).", "example": "TECHNOLOGY", "schema": { "type": "string", "enum": [ "TOP", "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "default": "TOP" } }, { "name": "country", "in": "query", "required": false, "description": "Two-letter ISO country code (default US).", "example": "US", "schema": { "type": "string", "default": "US" } }, { "name": "lang", "in": "query", "required": false, "description": "ISO 639-1 language code (default en).", "example": "en", "schema": { "type": "string", "default": "en" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of headlines to return (1 to 100, default 20).", "example": 20, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Top breaking headlines for the requested topic and country.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsResponse" }, "example": { "code": 0, "provider": "https://searchdataapi.com", "status": "ok", "msg": "success", "data": { "topic": "TECHNOLOGY", "country": "US", "lang": "en", "count": 3, "articles": [ { "position": 1, "title": "Zelda: Ocarina of Time Remake Sells 5 Million in Four Days, Yet Former Nintendo Leads Say The Series Sold \"Like Nothing\" Before Breath of the Wild", "url": "https://news.google.com/rss/articles/CBMirwFBVV95cUxPUklWZzlXU1gzQ3NWX2x3dVpOYnE5OU5WVE5pTFFjRVZNTlYzbTY4NWNqMzIxeXNNYlZwWTNDNkJMRWoxX3Boa3U5OU9WVmRLdDVfQldvYzBWWGdlN0kzcXhmUENtbEZja3pJa1NyLVpwcFA2TW96WlRwemk0ZHhoeU9CSTM1RGoxZ2hHdmxDcjc4YS14eVhwbUlrYkhGcV9kd3d5d0pTanctVmhQOWdF?oc=5", "snippet": "Zelda: Ocarina of Time Remake Sells 5 Million in Four Days, Yet Former Nintendo Leads Say The Series Sold \"Like Nothing\" Before Breath of the Wild    Wccftech The Legend of Zelda: Ocarina of Time for Nintendo Switch 2 sells over 5.2 million units worldwide in first four days    Nintendo The Legend of Zelda: Ocarina of Time Sets New Switch 2 Sales Record    Consequence of Sound Opinion: Nintendo Made Ocarina Of Time's Best Moment Even Better    Nintendo Life Legendary Game Returns in Remake of Nintendo’s “The Legend of Zelda: Ocarina of Time”    Roger Ebert", "published_at": "2026-11-13T12:24:10.000Z", "image_url": null, "authors": [], "source": { "name": "Wccftech", "url": "https://wccftech.com", "domain": "wccftech.com", "favicon": "https://www.google.com/s2/favicons?domain=wccftech.com&sz=64" } }, { "position": 2, "title": "Space Shuttle Endeavour new LA home opens at California Science Center in Exposition Park", "url": "https://news.google.com/rss/articles/CBMitgFBVV95cUxNYnQ3REtQVWdMM0ViRGFHRVBiektOamtSSmJIUjBOdWM2ZE5fTnJ6NmllbXhQT2NvUk81SnNXOGhYdDlVU2pzaFdQWjRqMF9iOEh3VkZDc3lLdDBvVHlhdDJqVElkTi1Wb2pNV3Qtd1JKNW04WVlObFppYmhmZklfMEtPQzRaSXlNRWVKSmZTUzI3VDFFLTVGcEpxMmIzb0RuV0NQU2Jocm9xTXdBR3JrdWhLeW9Id9IBuwFBVV95cUxOUGVJX2lkTkxZa2RfcXBFM3BCUEVRSmRpSDZGUENzaERNQTRlcUtVUV9Cd0NQc1Fwa3JzSTE4ZEJjU3k3cW5hdXc5UUdRN1l5ellmQXpDbzdFendNZ013bHNSenN3dXZpcDRIcTFURVplRDE0UGc1NFlPUUNSdXQ0ZGhTZGZjTGNFc0pTTXdvRG96UUtzaXhBTHBBOVpXV3FHQTZTUUZCNFhBNkRYN05IeWlidkliSFhuTVFn?oc=5", "snippet": "Space Shuttle Endeavour new LA home opens at California Science Center in Exposition Park    ABC7 Los Angeles Astronauts, kids enjoy opening of Samuel Oschin Air and Space Center - Los Angeles Times    Los Angeles Times Through NASA’s Lens: Capturing Space Shuttle Endeavour’s Move to LA    NASA (.gov) Samuel Oschin Air and Space Center    Arup California's brand-new Air & Space Center, home of the space shuttle Endeavour, opens today    Space", "published_at": "2026-11-13T21:36:57.000Z", "image_url": null, "authors": [], "source": { "name": "ABC7 Los Angeles", "url": "https://abc7.com", "domain": "abc7.com", "favicon": "https://www.google.com/s2/favicons?domain=abc7.com&sz=64" } }, { "position": 3, "title": "HomeView Tidbits: Mirror, Sleep Timer, and Other Details", "url": "https://news.google.com/rss/articles/CBMiZ0FVX3lxTFBkZ1owaFRKTFJrS0F3Ymw1MmNESGlCTWhiMk40a0xlN0t4VlRLQnRMWTlNeVdqS2tqVXJySkR0SHRhRXVKN3luVU1ESWV0R2p5N2NTbjZhQ3dNd3lFb2M2NXNlSHZBNWc?oc=5", "snippet": "HomeView Tidbits: Mirror, Sleep Timer, and Other Details    MacRumors I Spent a Week Testing Apple’s New HomeView. It’s ... Fine.    The New York Times Apple’s HomeView is my new favorite smart display — but not my daughter’s    The Verge Apple’s HomeView Makes Up for Late Arrival with Ecosystem Perks: Review    Bloomberg.com HomeView has one big problem: The iPad    Macworld", "published_at": "2026-11-13T22:04:35.000Z", "image_url": null, "authors": [], "source": { "name": "MacRumors", "url": "https://www.macrumors.com", "domain": "macrumors.com", "favicon": "https://www.google.com/s2/favicons?domain=macrumors.com&sz=64" } } ] }, "meta": { "request_id": "0e3c3124-402a-4330-8cfc-4aaea87f0ed8", "endpoint": "/v1/news/top", "count": 3, "credits_charged": 2, "cached": false, "took_ms": 192 } } } } } } } }, "/v1/autocomplete": { "get": { "operationId": "v1_autocomplete", "summary": "Sub-80ms Search Suggest & Typeahead Autocomplete API", "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.", "tags": [ "Typeahead Autocomplete" ], "x-credits-per-request": "1 Credit / query (0 if empty)", "x-price-per-request": "$0.0001 / query ($0.06–$0.10 / 1K queries)", "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Seed query prefix to expand (e.g., 'best crm for' or 'how to migrate from').", "example": "best crm for", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "Two-letter ISO country code (default us).", "example": "us", "schema": { "type": "string", "default": "us" } }, { "name": "lang", "in": "query", "required": false, "description": "ISO 639-1 language code (default en).", "example": "en", "schema": { "type": "string", "default": "en" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of autocomplete suggestions to return (1 to 20, default 10).", "example": 10, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 } } ], "responses": { "200": { "description": "Ordered list of real-time typeahead suggestions with completion suffixes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutocompleteResponse" }, "example": { "code": 0, "provider": "https://searchdataapi.com", "status": "ok", "msg": "success", "data": { "query": "best crm for", "country": "US", "lang": "en", "count": 5, "suggestions": [ { "position": 1, "suggestion": "best crm for real estate agents", "completion_suffix": "real estate agents", "word_count": 6 }, { "position": 2, "suggestion": "best crm for small business", "completion_suffix": "small business", "word_count": 5 }, { "position": 3, "suggestion": "best crm for real estate", "completion_suffix": "real estate", "word_count": 5 }, { "position": 4, "suggestion": "best crm for mortgage loan officers", "completion_suffix": "mortgage loan officers", "word_count": 6 }, { "position": 5, "suggestion": "best crm for service based business", "completion_suffix": "service based business", "word_count": 6 } ] }, "meta": { "request_id": "68bd83ac-33c2-4f2f-8ef2-bf91b3a40119", "endpoint": "/v1/autocomplete", "count": 5, "credits_charged": 1, "cached": false, "took_ms": 46 } } } } } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Pass your SearchData API key (prefix sr_live_...) in the x-api-key request header." }, "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Pass Authorization: Bearer sr_live_... or OAuth 2.1 token mcp_at_..." } }, "schemas": { "ResponseMeta": { "type": "object", "properties": { "request_id": { "type": "string", "description": "Unique UUIDv4 trace identifier." }, "endpoint": { "type": "string", "description": "Normalized /v1/* endpoint path." }, "count": { "type": "integer", "description": "Number of primary items returned." }, "credits_charged": { "type": "integer", "description": "Credits deducted (0 on empty or error)." }, "cached": { "type": "boolean", "description": "Whether served from L1/L2 edge cache." }, "took_ms": { "type": "integer", "description": "End-to-end gateway latency in milliseconds." } } }, "OrganicResult": { "type": "object", "properties": { "position": { "type": "integer", "description": "1-based SERP organic rank position." }, "title": { "type": "string", "description": "Result page title." }, "url": { "type": "string", "description": "Canonical destination URL." }, "domain": { "type": "string", "description": "Normalized hostname without www." }, "displayed_url": { "type": "string", "description": "Breadcrumb URL string shown in SERP." }, "snippet": { "type": "string", "description": "Highlighted SERP meta description snippet." }, "favicon": { "type": "string", "description": "64px domain favicon URL." }, "published_at": { "type": "string", "description": "Optional publication date string if detected." } } }, "PeopleAlsoAskItem": { "type": "object", "properties": { "question": { "type": "string", "description": "Expandable People Also Ask question." }, "snippet": { "type": "string", "description": "Extracted answer snippet." }, "title": { "type": "string", "description": "Cited source page title." }, "url": { "type": "string", "description": "Cited source URL." } } }, "SearchResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://searchdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "query": { "type": "string", "description": "Executed search query." }, "country": { "type": "string", "description": "ISO country code." }, "lang": { "type": "string", "description": "ISO language code." }, "count": { "type": "integer", "description": "Number of organic results returned." }, "offset": { "type": "integer", "description": "Current pagination offset." }, "has_more": { "type": "boolean", "description": "Whether more organic pages are available." }, "next_offset": { "type": "integer", "description": "Next offset value for pagination." }, "organic_results": { "type": "array", "items": { "$ref": "#/components/schemas/OrganicResult" } }, "people_also_ask": { "type": "array", "items": { "$ref": "#/components/schemas/PeopleAlsoAskItem" } }, "related_keywords": { "type": "array", "description": "Cleaned, deduplicated related search keywords returned natively from the SERP ([] when none).", "items": { "type": "string" } }, "related_searches": { "type": "array", "description": "Alias array mirroring related_keywords for SerpApi/Serper drop-in compatibility.", "items": { "type": "string" } } } }, "meta": { "$ref": "#/components/schemas/ResponseMeta" } } }, "TrendingSearchItem": { "type": "object", "properties": { "rank": { "type": "integer", "description": "1-based trending velocity rank." }, "keyword": { "type": "string", "description": "Trending search query." }, "approx_traffic": { "type": "string", "description": "Formatted search volume tier (e.g., 200K+, 500K+)." }, "traffic_volume_min": { "type": "integer", "description": "Parsed numeric floor of search volume." }, "status": { "type": "string", "description": "Velocity badge (breakout or rising)." }, "published_at": { "type": "string", "description": "ISO/RFC timestamp when trend began surging." }, "picture_url": { "type": "string", "description": "Thumbnail image URL." }, "picture_source": { "type": "string", "description": "Publisher attribution for thumbnail." } } }, "TrendsRealtimeResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://searchdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "country": { "type": "string", "description": "ISO country code." }, "category": { "type": "string", "description": "Trend category." }, "count": { "type": "integer", "description": "Number of trending items returned." }, "updated_at": { "type": "string", "description": "UTC timestamp of snapshot." }, "trending_searches": { "type": "array", "items": { "$ref": "#/components/schemas/TrendingSearchItem" } } } }, "meta": { "$ref": "#/components/schemas/ResponseMeta" } } }, "TrendTimelinePoint": { "type": "object", "properties": { "date_from": { "type": "string", "description": "Start date of weekly bucket (YYYY-MM-DD)." }, "date_to": { "type": "string", "description": "End date of weekly bucket (YYYY-MM-DD)." }, "timestamp": { "type": "integer", "description": "Unix epoch seconds." }, "value": { "type": "integer", "description": "Normalized 0–100 search interest index." } } }, "TrendsInterestResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://searchdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Primary keyword." }, "keywords": { "type": "array", "items": { "type": "string" } }, "country": { "type": "string", "description": "ISO country code." }, "weeks_count": { "type": "integer", "description": "Number of weekly data points (typically 52–54)." }, "summary": { "type": "object", "properties": { "current_index": { "type": "integer", "description": "Most recent week 0–100 score." }, "average_index": { "type": "number", "description": "54-week mean interest score." }, "peak_index": { "type": "integer", "description": "Peak score (100)." }, "peak_date": { "type": "string", "description": "Date of peak interest." }, "momentum_pct": { "type": "number", "description": "Recent 4-week vs prior 12-week velocity %." }, "trend_status": { "type": "string", "description": "breakout, rising, steady, or cooling." } } }, "timeline": { "type": "array", "items": { "$ref": "#/components/schemas/TrendTimelinePoint" } } } }, "meta": { "$ref": "#/components/schemas/ResponseMeta" } } }, "NewsArticleItem": { "type": "object", "properties": { "position": { "type": "integer", "description": "1-based article position." }, "title": { "type": "string", "description": "Headline title." }, "url": { "type": "string", "description": "Article URL." }, "snippet": { "type": "string", "description": "Article lead summary." }, "published_at": { "type": "string", "description": "ISO 8601 UTC publication timestamp." }, "image_url": { "type": "string", "description": "Article thumbnail image URL." }, "authors": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "properties": { "name": { "type": "string", "description": "Publisher name." }, "domain": { "type": "string", "description": "Publisher domain." }, "url": { "type": "string", "description": "Publisher homepage URL." }, "favicon": { "type": "string", "description": "Publisher logo/favicon URL." } } } } }, "NewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://searchdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "query": { "type": "string", "description": "Search query (for /v1/news/search)." }, "topic": { "type": "string", "description": "Topic code (for /v1/news/top)." }, "country": { "type": "string", "description": "ISO country code." }, "lang": { "type": "string", "description": "ISO language code." }, "count": { "type": "integer", "description": "Number of articles returned." }, "articles": { "type": "array", "items": { "$ref": "#/components/schemas/NewsArticleItem" } } } }, "meta": { "$ref": "#/components/schemas/ResponseMeta" } } }, "AutocompleteItem": { "type": "object", "properties": { "position": { "type": "integer", "description": "1-based suggestion rank." }, "suggestion": { "type": "string", "description": "Full completed query string." }, "completion_suffix": { "type": "string", "description": "Appended suffix beyond input prefix." }, "word_count": { "type": "integer", "description": "Word count of suggestion." } } }, "AutocompleteResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://searchdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "query": { "type": "string", "description": "Input prefix." }, "country": { "type": "string", "description": "ISO country code." }, "lang": { "type": "string", "description": "ISO language code." }, "count": { "type": "integer", "description": "Number of suggestions returned." }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/AutocompleteItem" } } } }, "meta": { "$ref": "#/components/schemas/ResponseMeta" } } } } }, "security": [ { "ApiKeyAuth": [] }, { "BearerAuth": [] } ] }