API universal de busca e dados web JSON estruturado para desenvolvedores e agentes de IA
Com uma única chave de API e uma requisição, você recebe JSON limpo de buscadores, redes sociais, e-commerce, mapas e da web. Cada endpoint informa seus parâmetros e o preço em créditos.
- Endpoints de API
- 47
- Categorias de dados
- 6
- Créditos por requisição
- 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")Execute uma busca real no Google antes de se cadastrar
Digite uma consulta e veja o JSON exato que seu código receberia, com código pronto para copiar em cURL, Python, JavaScript, Go, Java e PHP.
- Resposta de teste: até 5 resultados orgânicos mais o knowledge graph, a visão geral de IA, «As pessoas também perguntam» e os demais módulos que extraímos, em versão reduzida
- 1 crédito por busca com sua própria chave de API
- Nenhuma chave API é enviada pelo navegador.
POST /google/searchReferência da APIUm resultado real do Google capturado antes, no formato completo que a API retorna. Execute uma consulta para ver ao vivo.
{
"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
}Código
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"}'Pesquisa web do Google no seu aplicativo
Resultados estruturados, parâmetros documentados e status de resposta explícito.
Mecanismos de busca
Resultados de busca
Obtenha resultados com os parâmetros aceitos por cada endpoint.
Redes sociais
Recursos sociais individuais
Consulte perfis e publicações do TikTok e publicações do X individualmente. Não é busca social universal nem arquivo histórico.
Comércio eletrônico
Sugestões, produtos e apps da App Store
Autocompletar da Amazon e Walmart, consulta de produtos aceitos, busca Myntra e apps da App Store. Apple refere-se a apps, não hardware.
Extração web
Extração e ferramentas web
Extraia páginas, execute rastreamentos limitados ou gere UA. Todos têm preço fixo por solicitação, incluindo geração de UA.
API JSON simples
JSON limpo e consistente em respostas de busca, imagens, notícias, vídeos, Maps search e detalhes.
Preços por solicitação do catálogo
1–3 créditos / solicitação
Parâmetros regionais por produto
Consulte países e idiomas aceitos por endpoint. Parâmetros regionais não garantem saída de proxy em cada região.
Escolha seu pacote de créditos
Compare preços, créditos, limites e validade antes de comprar.
Créditos com vencimento
Estes créditos têm validade. Confira as condições de renovação e vencimento na compra.
Starter Boost
Pro Monthly
Assinatura mensal Pro
Créditos padrão sem vencimento por data
Créditos padrão permanecem em uma conta ativa até serem usados, sujeitos aos Termos. Não há teto mensal padrão, mas análises de pagamento, limites da conta e capacidade do serviço continuam aplicáveis.
Starter
US$ 0,50 / 1k
Growth
US$ 0,40 / 1k
Pro
US$ 0,35 / 1k
Business
US$ 0,33 / 1k
Enterprise
US$ 0,30 / 1k
Preços por solicitação do catálogo
| Categoria | Endpoints | créditos / solicitação |
|---|---|---|
| Mecanismos de busca | 18 | 1–2 |
| Redes sociais | 8 | 1–2 |
| Comércio eletrônico | 14 | 1–2 |
| Extração web | 3 | 1 |
| Imóveis | 1 | 2 |
| Mapas e lugares | 3 | 2–3 |
Ver os preços dos 47 endpoints
Como funciona a cobrança
Cada solicitação usa o preço fixo do catálogo, não uma tarifa por página. Web Crawl e User Agent custam atualmente 1 crédito por solicitação cada; User Agent não é gratuito. A ausência real confirmada pela fonte e identidade do recurso é cobrada. no_results, HTTP 404 ou falta de hydration/dados analisados, isoladamente, não provam ausência. Falhas executadas podem consumir créditos; não há garantia de reembolso de todas as falhas. credits_charged informa a cobrança real: 0 indica zero; null ou campo ausente significa desconhecido. charge_status UNKNOWN permanece desconhecido mesmo com valor numérico. Confira os registros e contate o suporte com request_id; não presuma reembolso nem repita solicitações às cegas.
Aumentos automáticos de QPS
Após confirmar o crédito, o total elegível USD eleva QPS no mínimo a: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Abaixo de $3 não altera o limite. Nunca reduz um limite superior; não é ilimitado.
| Recargas elegíveis acumuladas (USD) | QPS mínimo após o aumento |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
Só contam pagamentos USD credit_pack e auto_topup com crédito confirmado. Excluem-se assinaturas (incluindo Starter Boost), presentes e códigos. Saldo não equivale a pagamentos USD acumulados. Outras moedas não contam como USD sem conversão.
Todas as chaves, produtos e gateways da conta compartilham um limite QPS. Criar mais chaves não o aumenta.
O aumento ocorre após confirmar o crédito, não só ao voltar do pagamento. O limite atual é informado pelo servidor na conta; a sincronização das chaves pode demorar.
Confira os preços, créditos e validade em Faturamento antes da compra. Aplicam-se disponibilidade e limites da conta. Consulte sua conta para verificar créditos promocionais.
Perguntas antes de começar
O que os clientes realmente nos perguntam: créditos, limites, erros, páginas e pagamento.
Como começo? Existe teste grátis?
Toda conta nova começa com 100 créditos grátis, sem cartão. Crie uma chave de API com um clique na página de visão geral e envie sua primeira requisição pelo Playground ou pelo seu próprio código. A documentação tem exemplos prontos em curl, Python, JavaScript, Go, Java e PHP.
Como os créditos são cobrados? Requisições com falha custam algo?
Cada requisição custa o preço fixo indicado para o endpoint (a maioria, 1 crédito), independentemente de quantos resultados voltam. Nunca são cobrados: parâmetros inválidos, chave inválida, requisição acima do seu limite, falta de créditos e requisições que não chegaram à fonte de dados. Uma requisição que chegou à fonte e retornou um resultado utilizável é cobrada, mesmo que o resultado seja "nenhuma correspondência".
O campo credits_charged em cada resposta é o valor realmente descontado por aquela requisição.
Qual é meu limite de requisições e como aumento?
Aumentos automáticos de QPS
Após confirmar o crédito, o total elegível USD eleva QPS no mínimo a: $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500. Abaixo de $3 não altera o limite. Nunca reduz um limite superior; não é ilimitado.
| Recargas elegíveis acumuladas (USD) | QPS mínimo após o aumento |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
Só contam pagamentos USD credit_pack e auto_topup com crédito confirmado. Excluem-se assinaturas (incluindo Starter Boost), presentes e códigos. Saldo não equivale a pagamentos USD acumulados. Outras moedas não contam como USD sem conversão.
Todas as chaves, produtos e gateways da conta compartilham um limite QPS. Criar mais chaves não o aumenta.
O aumento ocorre após confirmar o crédito, não só ao voltar do pagamento. O limite atual é informado pelo servidor na conta; a sincronização das chaves pode demorar.
Uma requisição expirou ou deu erro. O crédito volta?
Falhas que a plataforma consegue provar que nunca foram executadas são reembolsadas automaticamente, sem pedido. Um tempo esgotado é diferente: a requisição pode ter sido concluída e o resultado se perdido na volta, então não há reembolso automático. Se você foi cobrado e não recebeu resultado, abra um ticket com o request_id da resposta e vamos verificar e corrigir.
O que significam os status 1029, 1503 e 1502? O serviço caiu?
Não. Todos os endpoints respondem HTTP 200; se a chamada deu certo está no campo status do corpo. 0 é sucesso. 1029 significa que você passou do seu próprio limite por segundo: espere os segundos do cabeçalho Retry-After e reenvie. 1503 significa que naquele instante não havia canal de busca livre: não é cobrado, basta tentar de novo em instantes. 1502 e 1504 indicam falha ou tempo esgotado da fonte de dados.
Quando o cabeçalho X-SerpBase-Retryable é true, reenviar a mesma requisição pode funcionar; quando é false, altere a requisição antes. Só uma sequência de falhas por vários minutos é anormal. Envie o request_id e nós verificamos.
Os resultados são de celular ou desktop? Posso obter o HTML original?
A busca do Google retorna por enquanto resultados com layout de celular; a opção desktop ainda não está disponível. Os endpoints retornam apenas JSON processado, não o HTML original do Google. Se precisar de algo diferente, fale conosco sobre um arranjo personalizado.
Como funciona a paginação e quais endpoints a suportam?
Aceitam o parâmetro page: busca web, de imagens, notícias, vídeos, Shopping, empregos, Scholar, livros e finanças do Google; busca no Google Maps (20 lugares por página); e busca na Amazon, eBay e Walmart. Cada página é uma requisição ao preço daquele endpoint. Não há parâmetro que retorne 100 resultados de uma vez.
Endpoints de detalhe, autocompletar e as buscas do YouTube e do Reddit retornam uma página por requisição e não têm parâmetro de paginação.
Os créditos expiram?
Créditos comprados em pacotes não expiram; ficam na sua conta. Créditos de assinaturas e promoções têm prazo, e avisamos por e-mail antes de vencerem. A página da conta mostra cada tipo separadamente.
Como posso pagar e consigo uma fatura?
Aceitamos cartões por meio de dois parceiros de pagamento e criptomoedas. Os créditos entram automaticamente após o pagamento, normalmente em minutos; se não entrarem, abra um ticket com o número do pedido.
As faturas são emitidas pelos nossos provedores de pagamento, que vendem em nosso nome como comerciante registrado. Para pagamentos com cartão pela Dodo, abra Cobrança, depois Pedidos, e use "Obter fatura" no pedido pago. A Creem envia o recibo para o e-mail usado no pagamento. Para pagamentos em cripto, abra um ticket e enviaremos um comprovante de pagamento.