Universal Web Intelligence API Clean, Structured JSON for Developers & AI Agents
Send one request with one API key and get clean JSON back from search engines, social media, e-commerce, maps and the web. Each endpoint lists its own parameters and credit price.
- API endpoints
- 47
- Data categories
- 6
- Credits per request
- 1–3
import requests
res = requests.post(
"https://api.serpbase.dev/google/search",
headers={"X-API-Key": "YOUR_API_KEY"},
json={"q": "best ai search agents", "gl": "us", "hl": "en"}
)
data = res.json()
print("Found", len(data["organic"]), "organic results")Run a live Google search before signing up
Type a query and see the exact JSON your code would receive, with ready-to-copy code in cURL, Python, JavaScript, Go, Java and PHP.
- Trial response: up to 5 organic results plus the knowledge graph, AI overview, People also ask and the other modules we parse, each trimmed
- 1 credit per search with your own API key
- No API key is sent from your browser.
POST /google/searchAPI referenceA real Google result captured earlier, in the full format the API returns. Run a query to replace it with a live trial response.
{
"credits_charged": 1,
"elapsed_ms": 1891,
"knowledge_graph": {
"attributes": {
"CEO": "Elon Musk (Oct 2008–)",
"Founded": "July 1, 2003, San Carlos, CA",
"Founders": "Elon Musk, Martin Eberhard, JB Straubel, Marc Tarpenning, Ian Wright",
"Headquarters": "Austin, TX",
"Number of employees": "134,785 (2025)",
"Subsidiaries": "Tesla Robotaxi, Tesla Energy, Tesla Automation"
},
"description": "Tesla, Inc. is an American multinational automotive and clean energy company. Headquartered in Austin, Texas, it designs, manufactures, and sells battery electric vehicles, stationary battery energy storage devices from home to grid-scale, solar panels and solar shingles, and related products and services.",
"description_link": "https://en.wikipedia.org/wiki/Tesla,_Inc.",
"description_source": "Wikipedia",
"title": "Tesla Inc",
"type": "NASDAQ: TSLA"
},
"organic": [
{
"display_link": "www.cnbc.com",
"display_url": "www.cnbc.com",
"link": "https://www.cnbc.com/2026/10/18/meta-tesla-netflix-earnings-preview.html",
"position": 1,
"rank": 1,
"sitelinks": [
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/disclaimer",
"source_url": "https://www.google.com/intl/en_us/googlefinance/disclaimer/?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQ1AF6BAg8EAI",
"title": "Disclaimer",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/disclaimer"
},
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/add-investments",
"source_url": "https://www.google.com/finance/portfolio/watchlist?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQnIcKegQIOxAJ",
"title": "Add investments",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/add-investments"
},
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/analyze-tesla-inc",
"source_url": "https://www.google.com/finance/quote/TSLA:NASDAQ?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQ3ecFKAV6BAg3EAY",
"title": "Analyze Tesla Inc",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/analyze-tesla-inc"
}
],
"source_url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg",
"title": "Meta Platforms and Tesla are among the companies set to report next week. What to expect",
"url": "https://www.cnbc.com/2026/10/18/meta-tesla-netflix-earnings-preview.html"
},
{
"date": "1 day ago",
"display_link": "https://finance.yahoo.com › quote › TSLA",
"display_url": "https://finance.yahoo.com › quote › TSLA",
"link": "https://finance.yahoo.com/quote/TSLA/",
"position": 2,
"published_at": "1 day ago",
"rank": 2,
"snippet": "Tesla, Inc. (TSLA) 28,957.36% Baseline. Close 354.72 Open 357.48 Bid 368.80. Range 354.47 - 369.58 52 Week Range 297.38 - 498.83 Volume 38,651, ...",
"source_url": "https://www.google.com/goto?url=CAESYAHrOzAV0Q2uc-d8mt2At-khHuHwKGSqkS85kXL44B4zKALhwjD9ayR0ZKi73coj1vwyaB_xHPc6mZIBSmsgCMCwZPdOM6X-lRMbFvgVXSWrIOBV2Z_a9cMdu_s6q2pXMg",
"title": "Tesla, Inc. (TSLA) Stock Price, News, Quote & History",
"url": "https://finance.yahoo.com/quote/TSLA/"
},
{
"display_link": "https://robinhood.com › Stocks",
"display_url": "https://robinhood.com › Stocks",
"link": "https://robinhood.com/us/en/stocks/TSLA/",
"position": 3,
"rank": 3,
"snippet": "Tesla(TSLA) stock is priced at $352.46, giving the company a market capitalization of 1.45T. It carries a P/E multiple of 329.57.Read more",
"source_url": "https://www.google.com/goto?url=CAESYwHrOzAVFdXXVy2WHCo2zyJ0zvAjoVAxjvBKIvXLNvbD6OCsjsP-8htxx9D8A1D-I8VqVoeHGSzvi6TbF7PKLC9S6QDjMf1pv9xpAYotE5ghRO2WpJx8iHq7gOL83EqskLIoHA",
"title": "Tesla: TSLA Stock Price Quote & News",
"url": "https://robinhood.com/us/en/stocks/TSLA/"
},
{
"display_link": "https://digital.fidelity.com › dashboard › summary",
"display_url": "https://digital.fidelity.com › dashboard › summary",
"link": "https://digital.fidelity.com/prgw/digital/research/quote/dashboard/summary?symbol=TSLA",
"position": 4,
"rank": 4,
"snippet": "Tesla (TSLA) is trading at 368.06 Open Price 357.5 Previous close 368.06. Index NASDAQ100,R1000,R3000,SP500",
"source_url": "https://www.google.com/goto?url=CAESkQEB6zswFb-ymy1HS3Xh0knUQK1be6f5_Eowhon8_aQ7_ySuUyWRlAab4azfRGqczuuNPmibG-tzLzN7L4F0s85H4ksfzjUYY2TEj8j1VdjjBK65X_vQGhIomtlEw8jss1FxxGJVCTfhJeBpydQ7Ezuwuk3n4nZsb2NLxY9LPIusRstMVrUxtKdpSf4kn-nx6y1c",
"title": "TSLA - TESLA INC | Stock Quotes from Fidelity Investments",
"url": "https://digital.fidelity.com/prgw/digital/research/quote/dashboard/summary?symbol=TSLA"
},
{
"display_link": "https://www.cnbc.com › quotes › TSLA",
"display_url": "https://www.cnbc.com › quotes › TSLA",
"link": "https://www.cnbc.com/quotes/TSLA",
"position": 5,
"rank": 5,
"snippet": "Tesla Inc TSLA:NASDAQ · Open370.28 · Day High370.49 · Day Low363.64 · Prev Close368.06 · 52 Week High498.83 · 52 Week High Date12/22/25 · 52 Week Low297.38 · 52 ...Read more",
"source_url": "https://www.google.com/goto?url=CAESWwHrOzAVo4AO4qr2Iq60j4OH2YbKg-TOOGMssl83NF71AsNIA53itxwKGja5AilksVbY9HbfLvjY3Rbi2UurKYIyJyf8ozBgzIa--MlEAPg5lJ6ezfla5Sl7ZDw",
"title": "TSLA: Tesla Inc - Stock Price, Quote and News",
"url": "https://www.cnbc.com/quotes/TSLA"
},
{
"display_link": "https://www.tradingview.com › ... › Motor Vehicles",
"display_url": "https://www.tradingview.com › ... › Motor Vehicles",
"link": "https://www.tradingview.com/symbols/NASDAQ-TSLA/",
"position": 6,
"rank": 6,
"snippet": "The current price of TSLA is 368.06 USD — it has increased by 3.76% in the past 24 hours. TSLA stock has fallen by −3.80% TSLA price has a max estimate of 550. ...",
"source_url": "https://www.google.com/goto?url=CAESawHrOzAVchvcp21W18wx27C_wPhTYaxXLLwonMPNzDSAnKYzWqkq4O-WRNM1q5B6bAF7B0Z-Jlq3yrw2W4qE_thS4lSkzuxNgAjBWK9nZ4JFhKfpmd6mAMpCRk7f2fbix3jIwRp81UYUv72b",
"title": "TSLA Stock Price - Tesla, Inc.",
"url": "https://www.tradingview.com/symbols/NASDAQ-TSLA/"
},
{
"display_link": "https://www.google.com › quote › TSLA:NASDAQ",
"display_url": "https://www.google.com › quote › TSLA:NASDAQ",
"link": "https://www.google.com/finance/quote/TSLA:NASDAQ",
"position": 7,
"rank": 7,
"snippet": "Tesla Inc (TSLA) Stock. Avg. vol. 35.25M Volume 538.84K … low $297.38 EPS $1.08 Beta 1.92 Shares outstanding 3.95B No. of employees 135K Mkt. cap 1.45T",
"source_url": "https://www.google.com/finance/quote/TSLA:NASDAQ",
"title": "Tesla Inc (TSLA) Stock Price & News - Google Finance",
"url": "https://www.google.com/finance/quote/TSLA:NASDAQ"
},
{
"display_link": "https://seekingalpha.com › symbol › TSLA",
"display_url": "https://seekingalpha.com › symbol › TSLA",
"link": "https://seekingalpha.com/symbol/TSLA",
"position": 8,
"rank": 8,
"snippet": "Tesla, Inc. is currently listed on NASDAQ under TSLA. One share of TSLA stock can currently be purchased for approximately $354.72.",
"source_url": "https://www.google.com/goto?url=CAESXwHrOzAV1wVdOIkoPpUFdDyBhccUJG8KNL_oE0sHSKVPU-quqsjKd_lhrtRhteu3lsfw2-5APEA_rckH5iLsgatc2oyJfZH7X7dmo_ZWTGgF478c4QQ5jYlaetIg42St",
"title": "Tesla, Inc. (TSLA) Stock Price, Quote, News & Analysis",
"url": "https://seekingalpha.com/symbol/TSLA"
}
],
"page": 1,
"people_also_ask": [
{
"question": "Is Tesla a buy or sell today?"
},
{
"question": "How much will Tesla stock be worth in 5 years?"
},
{
"question": "How much is $10,000 invested in Tesla 10 years ago?"
},
{
"question": "Can Tesla stock reach $3000?"
}
],
"product_id": "google_web_search",
"query": "tesla stock",
"related_searches": [
"NASDAQ: NVDA",
"SHE: 002594",
"NASDAQ: AAPL",
"NYSE: TM",
"Elon Musk",
"Austin, Texas",
"San Carlos, California",
"Martin Eberhard"
],
"request_id": "r-sample-google-web-search",
"search_type": "search",
"status": 0
}Code
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"iPhone","hl":"en","gl":"us"}'Multi-Platform Data Infrastructure for Modern Applications & AI Agents
Search engines, social media intelligence, e-commerce catalog data, real estate listings, and universal web crawling behind a single standard API.
Search engines
Multi-Engine Search (Google & DuckDuckGo)
Retrieve search results using supported endpoint parameters.
Social media
Social Media Intelligence (TikTok & X)
Look up individual TikTok profiles, TikTok posts and X posts. Not universal social search or a historical archive.
E-commerce
Retail suggestions, products and App Store apps
Amazon and Walmart autocomplete, supported retail product lookups, Myntra search and Apple App Store app lookup. Apple means apps, not hardware.
Web scraping
Universal Web Scrape & Crawl
Extract pages, run bounded crawls or generate user-agent strings. Each uses a fixed catalog request price, including user-agent generation.
Unified JSON Standard
Clean, predictable JSON structures across search, social, marketplace, and crawler endpoints.
Catalog-based request pricing
1–3 credits / request
Product-specific locale parameters
Consult each endpoint for supported country and language inputs. Locale parameters do not guarantee a proxy exit in every region.
Choose your credit package
Compare current prices, credits, purchase limits and validity before buying.
Time-limited credits
These credits have a validity period. Check the package and checkout for renewal and expiry terms.
Starter Boost
Pro Monthly
Pro monthly subscription
Prepaid credit packs · credits never expire
Pay once and use credits whenever you need them; they do not expire on a date. Larger packs cost less per 1k requests and unlock higher QPS.
Starter
$0.50 / 1k
Growth
$0.40 / 1k
Pro
$0.35 / 1k
Business
$0.33 / 1k
Enterprise
$0.30 / 1k
Catalog request prices
| Category | Endpoints | credits / request |
|---|---|---|
| Search engines | 18 | 1–2 |
| Social media | 8 | 1–2 |
| E-commerce | 14 | 1–2 |
| Web scraping | 3 | 1 |
| Real estate | 1 | 2 |
| Maps and places | 3 | 2–3 |
Show all 47 endpoint prices
How billing works
Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.
Automatic account QPS upgrades
After an eligible top-up is confirmed as credited, cumulative USD thresholds raise account QPS to at least: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Below $3, your current account limit is unchanged. Upgrades only raise the limit; they never lower an existing higher limit. This is not unlimited QPS.
| Cumulative eligible top-ups (USD) | Upgrade to at least (QPS) |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
Only USD credit-pack (credit_pack) and automatic top-up (auto_topup) payments confirmed as credited count. Subscriptions (including Starter Boost), gifts and gift codes do not count. Credit balances are not cumulative USD payments. Non-USD payments are not counted as USD without currency conversion.
All API keys, products and gateways for the same account share one QPS limit. Creating more keys does not increase it.
Eligible top-ups automatically raise account QPS after confirmed crediting, not merely after returning from checkout. The current limit is the server-reported value shown in your account; API key synchronization may briefly lag.
Current prices, credit amounts and expiry terms are shown in Billing before purchase. Availability and account limits apply. Check your account for any promotional credits.
Questions before you start
The things customers actually ask us: credits, limits, errors, pages, payment.
How do I get started? Is there a free trial?
Every new account starts with 100 free credits, no card needed. Create an API key in one click on the overview page, then send your first request from the Playground or your own code. The docs have copy-ready examples in curl, Python, JavaScript, Go, Java and PHP.
How are credits charged? Do failed requests cost anything?
Each request costs the fixed price listed for that endpoint (most are 1 credit), no matter how many results come back. These are never charged: invalid parameters, an invalid key, a request over your rate limit, no credits left, and any request that never reached the data source. A request that reached the source and returned a usable result is charged, even if the result is "no matches".
The credits_charged field in every response is the amount actually taken for that request.
What is my rate limit, and how do I raise it?
Automatic account QPS upgrades
After an eligible top-up is confirmed as credited, cumulative USD thresholds raise account QPS to at least: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Below $3, your current account limit is unchanged. Upgrades only raise the limit; they never lower an existing higher limit. This is not unlimited QPS.
| Cumulative eligible top-ups (USD) | Upgrade to at least (QPS) |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
Only USD credit-pack (credit_pack) and automatic top-up (auto_topup) payments confirmed as credited count. Subscriptions (including Starter Boost), gifts and gift codes do not count. Credit balances are not cumulative USD payments. Non-USD payments are not counted as USD without currency conversion.
All API keys, products and gateways for the same account share one QPS limit. Creating more keys does not increase it.
Eligible top-ups automatically raise account QPS after confirmed crediting, not merely after returning from checkout. The current limit is the server-reported value shown in your account; API key synchronization may briefly lag.
A request timed out or returned an error. Do I get the credit back?
Failures the platform can prove were never executed are refunded automatically; nothing to request. A timeout is different: the request may have completed with the result lost on the way back, so it is not refunded automatically. If you were charged and got no result, open a ticket with the request_id from the response and we will check it and put it right.
What do status 1029, 1503 and 1502 mean? Is the service down?
No. Every endpoint answers HTTP 200; whether the call succeeded is in the status field of the body. 0 is success. 1029 means you went over your own per-second limit: wait the number of seconds in the Retry-After header and send again. 1503 means no fetch channel was free at that instant: not charged, just retry shortly. 1502 and 1504 mean the data source failed or timed out.
When the X-SerpBase-Retryable header is true, resending the same request can succeed; when it is false, change the request first. Only a steady stream of failures lasting several minutes is unusual. Send us the request_id and we will look.
Are results mobile or desktop? Can I get the raw HTML?
Google search currently returns mobile-layout results; a desktop option is not available yet. Endpoints return parsed JSON only, not Google's raw HTML. If you need something different, contact us about a custom arrangement.
How does paging work, and which endpoints support it?
These endpoints take a page parameter: Google Web, Images, News, Videos, Shopping, Jobs, Scholar, Books and Finance search; Google Maps search (20 places per page); and Amazon, eBay and Walmart search. Each page is one request at that endpoint's price. There is no parameter that returns 100 results at once.
Detail endpoints, autocomplete, and YouTube and Reddit search return one page per request and have no paging parameter.
Do credits expire?
Credits bought as packs do not expire; they stay in your account. Credits from subscriptions and promotions are time-limited, and we email you before they expire. The account page shows each kind separately.
How can I pay, and can I get an invoice?
We accept cards through two payment partners, and cryptocurrency. Credits land in your account automatically after payment, normally within minutes; if they have not arrived, open a ticket with the order number.
Invoices are issued by our payment providers, which sell on our behalf as the merchant of record. For card payments through Dodo, open Billing, then Orders, and use "Get invoice" on the paid order. Creem sends its receipt to the email used at checkout. For crypto payments, open a ticket and we will send a payment confirmation.