Obtenha uma chave secreta em API Keys e envie em X-API-Key, nunca em URL ou código público. Siga o método e os parâmetros do produto. HTTP 200 não prova sucesso: verifique status e error. Playground pode consumir créditos.
Resposta comum
Preço por solicitação; falhas executadas podem consumir créditos
Identificador para suporte
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: your_api_key' \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'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.
Preços por solicitação e como interpretar as cobranças informadas.
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.
- Google Web Search: 1 créditos / solicitação
- Google Images Search: 1 créditos / solicitação
- Google News Search: 1 créditos / solicitação
- Google Videos Search: 1 créditos / solicitação
- Google Maps Search: 2 créditos / solicitação
- Google Maps Place Detail: 3 créditos / solicitação
- Google Maps Reviews: 2 créditos / solicitação
- Google Search Autocomplete: 1 créditos / solicitação
- Google Shopping Search: 2 créditos / solicitação
- Google Jobs Search: 2 créditos / solicitação
- Google Scholar Search: 2 créditos / solicitação
- Google Books Search: 1 créditos / solicitação
- Google Finance Search: 1 créditos / solicitação
- Google Patent Details: 2 créditos / solicitação
- Google Play Search: 1 créditos / solicitação
- Google Play App Details: 1 créditos / solicitação
- Google Trends: 2 créditos / solicitação
- Google Trends Autocomplete: 2 créditos / solicitação
- Google Trends Trending Now: 2 créditos / solicitação
- Bing Web Search: 1 créditos / solicitação
- DuckDuckGo Search: 1 créditos / solicitação
- Reddit Post & Comments: 2 créditos / solicitação
- Reddit Search: 1 créditos / solicitação
- TikTok Post: 2 créditos / solicitação
- TikTok Profile: 2 créditos / solicitação
- TikTok Search: 1 créditos / solicitação
- X Post Details: 1 créditos / solicitação
- YouTube Search: 1 créditos / solicitação
- YouTube Video Transcripts: 2 créditos / solicitação
- Ajio Product Details: 2 créditos / solicitação
- Amazon Product Details: 2 créditos / solicitação
- Amazon Product Reviews: 2 créditos / solicitação
- Amazon Product Search: 2 créditos / solicitação
- Amazon Search Autocomplete: 1 créditos / solicitação
- Apple Product Details: 1 créditos / solicitação
- eBay Product Details: 2 créditos / solicitação
- eBay Product Search: 1 créditos / solicitação
- Flipkart Product Details: 2 créditos / solicitação
- Myntra Product Details: 2 créditos / solicitação
- Myntra Search: 2 créditos / solicitação
- Walmart Product Details: 2 créditos / solicitação
- Walmart Product Search: 2 créditos / solicitação
- Walmart Search Autocomplete: 1 créditos / solicitação
- User-Agent Generator: 1 créditos / solicitação
- Web Crawl: 1 créditos / solicitação
- Web Scrape: 1 créditos / solicitação
- Zillow Property Search: 2 créditos / solicitação
Use o servidor MCP aberto ou a habilidade portátil para Claude, Codex, Cursor, Cline/Roo, opencode ou outros agentes chamarem SerpBase com sua chave.
Integração MCP para clientes IA com ferramentas. Confira o catálogo antes de escolher uma ferramenta de busca.
Para Claude, Codex, Cursor, Cline/Roo, Continue e outros clientes MCP.
Pasta de habilidade portátil e alternativa de shell para agentes que leem instruções locais ou precisam de um script leve em vez de MCP.
Para habilidades Codex, memória Claude Code, opencode, agentes tipo OpenClaw e processos com shell.
{
"mcpServers": {
"serpbase": {
"command": "python",
"args": ["-m", "serpbase_mcp"],
"env": {
"SERPBASE_API_KEY": "your_api_key"
}
}
}
}Use $serpbase-skill to search Google through SerpBase and return cited structured results.Consulta o saldo atual de créditos da conta associada a uma API key ativa. Esta solicitação não consome créditos de pesquisa.
/account/creditsEnvie a chave no cabeçalho X-API-Key. API keys em parâmetros da URL não são aceitas.
curl https://api.serpbase.dev/account/credits \
-H "X-API-Key: your_api_key"{
"status": 0,
"credits": 12345,
"permanent_credits": 10000,
"expiring_credits": 2345,
"expiring_expires_at": 1798761600
}O endpoint é limitado a 60 solicitações por minuto por conta. expiring_expires_at é um timestamp Unix em segundos e vale 0 quando não há créditos temporários ativos.
Respostas bem-sucedidas retornam a mesma metadata superior. Os dados especificos ficam em organic, images, news, videos, places ou place.
statusnumberobrigatorio
Codigo de status de negocio. 0 significa sucesso.
request_idstringobrigatorio
ID estavel para suporte, retentativas e correlacao de logs.
elapsed_msnumberobrigatorio
Duracao observada pelo gateway em milissegundos.
credits_chargednumber | nullobrigatorio
Creditos cobrados apos aplicar reembolsos.
search_typestringopcional
Tipo de resposta do produto, quando retornado.
/google/searchBusque Google com q, idioma hl, país gl e dispositivo aceito. As seções dependem da consulta e da origem.
/google/image/searchBusque imagens e links de origem no Google. Os links não concedem direitos de uso.
/google/news/searchBusque Google News por tema ou palavras-chave. Artigos e editores dependem da origem.
/google/videos/searchBusque listagens de vídeos do Google; não baixa vídeos nem remove marcas-d’água.
/google/maps/searchBusque lugares do Google Maps por consulta e localização. Use o endpoint de detalhes para um lugar identificado.
/google/maps/detailConsulte um lugar do Google Maps por ID. Complementa a busca e tem seu próprio preço por solicitação.
/google/maps/reviewsPrimeira página de avaliações do Google Maps de um local (por data_id): nota, texto, data, fotos e autor. Ainda não inclui respostas do proprietário.
/google/autocompleteObtenha sugestões do Google por prefixo; não são medições de volume de buscas.
/google/shoppingBusque Google Shopping por consulta; é um retrato pontual, não monitoramento contínuo de preços.
/google/jobsBusque vagas do Google por cargo ou palavra-chave; retorna as disponíveis, não envia candidaturas.
/google/scholarBusque Google Scholar por tema ou palavra-chave; os metadados não garantem acesso ao texto completo.
/google/booksBusque Google Books por título, autor ou palavra-chave; não inclui downloads irrestritos.
/google/financeConsulte Google Finance por empresa ou termo financeiro; não é fluxo de mercado nem API de negociação.
/google/patents/detailObtenha uma patente do Google Patents pelo número de publicação: título, resumo, reivindicações, inventores, titulares e datas.
/google/play/searchPesquise apps no Google Play por palavra-chave; retorna nome, nome do pacote, ícone e link da loja. Não baixa apps.
/google/play/appObtenha um app do Google Play pelo nome do pacote: nome, desenvolvedor, descrição, preço, versão, datas de lançamento e classificação etária.
/google/trendsGoogle Trends: interesse ao longo do tempo, por região e pesquisas relacionadas para até cinco termos separados por vírgula.
/google/trends/autocompleteSugestões de tópicos do Google Trends para uma palavra-chave, com tipo e identificador de cada tópico.
/google/trends/trendingPesquisas em alta agora no Google Trends para um país (EUA por padrão) nas últimas 24 horas.
/bing/searchExecute Bing web searches with query, country cc, and language setlang parameters for organic search results.
/duckduckgo/searchBusque DuckDuckGo HTML com filtros aceitos de mercado e data. Continue com o cursor retornado, não páginas numeradas.
/reddit/postRetrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
/reddit/searchSearch public Reddit posts and discussion threads across subreddits by keyword query.
/tiktok/postConsulte uma publicação TikTok por ID e usuário; não descobre todas as publicações do perfil.
/tiktok/profileConsulte um perfil TikTok por usuário. Depende do acesso à origem; não é um arquivo histórico de audiência.
/tiktok/searchPesquise vídeos do TikTok por palavra-chave: links, legendas, autores, visualizações, curtidas, comentários, compartilhamentos, hashtags e capas; 16 por página por padrão.
/x/postConsulte uma publicação X por ID; não é busca por palavras, exportação de linha do tempo nem streaming.
/youtube/searchSearch YouTube videos, Shorts, and creator channels with query and region parameters.
/youtube/transcriptsExtract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
/ajio/productConsulta um produto AJIO pela URL HTTPS /p/; não exporta catálogos.
/amazon/productRetrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
/amazon/reviewsExtract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
/amazon/searchSearch Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
/amazon/autocompleteObtenha sugestões da Amazon por prefixo, não detalhes nem histórico de preços.
/apple/productConsulte apps da App Store por ID numérico ou URL apps.apple.com e país; não hardware Apple.
/ebay/productRetrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
/ebay/searchSearch eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
/flipkart/productConsulte Flipkart por URL de produto com /p/. Use uma URL específica, não uma busca.
/myntra/productConsulte um produto Myntra por URL /buy; é separado da busca.
/myntra/searchBusque Myntra por consulta ou URL aceita. Aceita páginas numeradas, não cursores nem alterações de tamanho da página.
/walmart/productExtract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
/walmart/searchSearch Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
/walmart/autocompleteObtenha sugestões do Walmart por consulta; não consulta páginas de produtos.
/web/user-agentGere UA de desktop ou móvel com user_agent_type e user_agent_count (1–5). A operação local também tem preço de catálogo.
/web/crawlInicie rastreamento limitado por URL pública. Preço fixo por solicitação, não multiplicado pelas páginas retornadas.
/web/scrapeExtraia páginas públicas HTTP/HTTPS por URL com texto, HTML, Markdown e seletores; aplicam-se restrições da origem. Páginas do Google não são suportadas; use os endpoints do Google, como /google/search.
/zillow/searchConsulte Zillow por URL homes aceita. É um retrato dos anúncios, não avaliações nem fluxo de transações.
/google/searchSearch
Busque Google com q, idioma hl, país gl e dispositivo aceito. As seções dependem da consulta e da origem.
Busque Google com q, idioma hl, país gl e dispositivo aceito. As seções dependem da consulta e da origem.
qstringobrigatorio
Texto da busca.
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
pagenumberopcional
Numero da pagina a partir de 1. Padrao: 1.
device"default" | "pc" | "mobile"opcional
Somente para Google Search. default usa roteamento automatico, pc usa sessoes desktop e mobile usa sessoes mobile.
{
"device": "mobile",
"gl": "us",
"hl": "en",
"q": "coffee shops"
}querystringobrigatorio
Consulta normalizada da requisicao.
pagenumberobrigatorio
Numero da pagina atual a partir de 1.
organicOrganicResult[]Quando resultados orgânicos são analisados.
Resultados orgânicos.
featured_snippetFeaturedSnippetQuando Google mostra um trecho em destaque.
Cartão de resposta em destaque, separado dos resultados orgânicos.
top_storiesTopStory[]Quando há notícias em destaque nos resultados.
Módulo de notícias em destaque.
people_also_askPAA[]Quando há perguntas relacionadas.
Pergunta, resposta e links de origem.
knowledge_graphKnowledgeGraphQuando um painel de conhecimento é analisado.
Dados do painel da entidade.
related_searchesstring[]Quando há sugestões relacionadas.
Consultas relacionadas.
ranknumberobrigatorio
Posicao no ranking a partir de 1 nesta resposta.
positionnumberAlias de rank quando disponivel.
Alias normalizado para clientes que esperam position.
titlestringobrigatorio
Titulo do resultado.
linkstringobrigatorio
Link principal retornado pelo parser.
urlstringPresente quando o link pode ser normalizado.
URL canonica de destino, normalmente igual a link.
source_urlstringSomente quando uma URL fonte do Google e observada.
URL original do Google para depuracao e procedencia.
display_urlstringQuando texto visivel ou dominio pode ser derivado.
URL visivel ou dominio de origem.
display_linkstringQuando há texto exibido pelo Google.
Texto original do link exibido pelo Google.
snippetstringQuando um trecho é analisado.
Resumo do resultado orgânico.
datestringQuando Google inclui data no trecho.
Texto original da data extraído do trecho.
published_atstringAlias da data analisada, se existir.
Alias da data normalizada.
iconstringQuando um favicon ou imagem é exposto.
URL do ícone do resultado.
sitelinks{ title, link, url, source_url?, display_url? }[]Quando há links de site.
Links de site aninhados do resultado.
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio",
"hl": "en",
"gl": "us",
"page": 1,
"device": "default"
}'Grounding, SEO e extracao de respostas.
Também pode retornar ai_overview, weather, finance, flight e result_stats se aparecerem nos resultados.
/google/image/searchImagens
Busque imagens e links de origem no Google. Os links não concedem direitos de uso.
Busque imagens e links de origem no Google. Os links não concedem direitos de uso.
qstringobrigatorio
Texto da busca.
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
pagenumberopcional
Numero da pagina a partir de 1. Padrao: 1.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "red pandas"
{
"query": "red pandas"
}querystringobrigatorio
Consulta normalizada da requisicao.
pagenumberobrigatorio
Numero da pagina atual a partir de 1.
imagesImageResult[]Quando imagens são analisadas.
Resultados do Google Imagens.
ranknumberobrigatorio
Posicao no ranking a partir de 1 nesta resposta.
positionnumberAlias de rank quando disponivel.
Alias normalizado para clientes que esperam position.
titlestringQuando titulo ou alt da imagem e analisado.
Titulo do resultado.
linkstringobrigatorio
Link principal retornado pelo parser.
urlstringPresente quando o link pode ser normalizado.
URL canonica de destino, normalmente igual a link.
source_urlstringSomente quando uma URL fonte do Google e observada.
URL original do Google para depuracao e procedencia.
display_urlstringQuando texto visivel ou dominio pode ser derivado.
URL visivel ou dominio de origem.
image_urlstringobrigatorio
URL da imagem completa.
thumbnail_urlstringQuando o Google expoe uma miniatura.
URL da miniatura.
thumbnailstringAlias de thumbnail_url quando disponivel.
Alias normalizado da miniatura.
sourcestringQuando texto de origem é analisado.
Rótulo de origem da imagem.
domainstringQuando é possível obter o domínio de origem.
Domínio da página de origem.
curl -X POST 'https://api.serpbase.dev/google/image/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"red pandas"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/image/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "iphone 15 pro blue",
"hl": "en",
"gl": "us",
"page": 1
}'Busca visual, monitoramento de produtos e fontes.
Alguns formatos expõem apenas rank/link, não todos os aliases. Trate url, display_url, source_url, position e thumbnail como opcionais.
/google/news/searchNoticias
Busque Google News por tema ou palavras-chave. Artigos e editores dependem da origem.
Busque Google News por tema ou palavras-chave. Artigos e editores dependem da origem.
qstringobrigatorio
Texto da busca.
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
pagenumberopcional
Numero da pagina a partir de 1. Padrao: 1.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "semiconductor supply"
{
"query": "semiconductor supply"
}querystringobrigatorio
Consulta normalizada da requisicao.
pagenumberobrigatorio
Numero da pagina atual a partir de 1.
newsNewsResult[]Quando notícias são analisadas.
Resultados do Google Notícias.
ranknumberobrigatorio
Posicao no ranking a partir de 1 nesta resposta.
positionnumberAlias de rank quando disponivel.
Alias normalizado para clientes que esperam position.
titlestringobrigatorio
Titulo do resultado.
linkstringobrigatorio
Link principal retornado pelo parser.
urlstringPresente quando o link pode ser normalizado.
URL canonica de destino, normalmente igual a link.
source_urlstringSomente quando uma URL fonte do Google e observada.
URL original do Google para depuracao e procedencia.
display_urlstringQuando texto visivel ou dominio pode ser derivado.
URL visivel ou dominio de origem.
sourcestringQuando o editor é analisado.
Rótulo de editor ou origem.
timestringQuando Google expõe texto de tempo.
Texto original de publicação.
published_atstringAlias do tempo analisado, se existir.
Alias do tempo de publicação normalizado.
snippetstringQuando um trecho é analisado.
Trecho de resumo do artigo.
thumbnail_urlstringQuando o Google expoe uma miniatura.
URL da miniatura.
thumbnailstringAlias de thumbnail_url quando disponivel.
Alias normalizado da miniatura.
curl -X POST 'https://api.serpbase.dev/google/news/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"semiconductor supply"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/news/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "apple event",
"hl": "en",
"gl": "us",
"page": 1
}'Monitoramento de marca, tendencias e midia.
Origem e tempo são analisados de metadados compactos do Google; ambos são opcionais.
/google/videos/searchVideos
Busque listagens de vídeos do Google; não baixa vídeos nem remove marcas-d’água.
Busque listagens de vídeos do Google; não baixa vídeos nem remove marcas-d’água.
qstringobrigatorio
Texto da busca.
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
pagenumberopcional
Numero da pagina a partir de 1. Padrao: 1.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "how espresso machines work"
{
"query": "how espresso machines work"
}querystringobrigatorio
Consulta normalizada da requisicao.
pagenumberobrigatorio
Numero da pagina atual a partir de 1.
videosVideoResult[]Quando vídeos são analisados.
Resultados do Google Vídeos.
ranknumberobrigatorio
Posicao no ranking a partir de 1 nesta resposta.
positionnumberAlias de rank quando disponivel.
Alias normalizado para clientes que esperam position.
titlestringobrigatorio
Titulo do resultado.
linkstringobrigatorio
Link principal retornado pelo parser.
urlstringPresente quando o link pode ser normalizado.
URL canonica de destino, normalmente igual a link.
source_urlstringSomente quando uma URL fonte do Google e observada.
URL original do Google para depuracao e procedencia.
display_urlstringQuando texto visivel ou dominio pode ser derivado.
URL visivel ou dominio de origem.
sourcestringQuando é possível analisar origem ou canal.
Origem ou canal do vídeo.
durationstringQuando a duração aparece no resultado.
Texto de duração do vídeo.
timestringQuando é possível analisar a data de publicação.
Texto original da data de publicação.
published_atstringAlias do tempo analisado, se existir.
Alias normalizado da data de publicação.
thumbnail_urlstringQuando o Google expoe uma miniatura.
URL da miniatura.
thumbnailstringAlias de thumbnail_url quando disponivel.
Alias normalizado da miniatura.
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"how espresso machines work"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/videos/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio tutorial",
"hl": "en",
"gl": "us",
"page": 1
}'Busca de videos, tutoriais e monitoramento.
Sem cartões de vídeo, usa-se extração de notícias em layouts Google compatíveis.
/google/maps/searchMaps Search
Busque lugares do Google Maps por consulta e localização. Use o endpoint de detalhes para um lugar identificado.
Busque lugares do Google Maps por consulta e localização. Use o endpoint de detalhes para um lugar identificado.
qstringobrigatorio
Texto da busca.
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
pagenumberopcional
Numero da pagina a partir de 1. Padrao: 1.
latnumberopcional
Latitude do centro do mapa. Deve ser enviada com lng.
lngnumberopcional
Longitude do centro do mapa. Deve ser enviada com lat.
zoomnumberopcional
Zoom do mapa de 1 a 21. Padrao: 14 com coordenadas.
locationobjectExemplo do catálogo; a API valida campos obrigatórios.
exemplo: {"location_query":"Seattle, WA"}
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee"
{
"location": {
"location_query": "Seattle, WA"
},
"query": "coffee"
}querystringobrigatorio
Consulta normalizada da requisicao.
pagenumberobrigatorio
Numero da pagina atual a partir de 1.
placesMapsPlace[]Quando lugares locais são analisados.
Resultados de lugares locais.
positionnumberSomente Maps Search.
Posição do lugar nos resultados locais.
namestringobrigatorio
Nome do lugar.
titlestringobrigatorio
Alias de name.
feature_idstringobrigatorio
ID de elemento do Google Maps.
place_idstringQuando Google o expõe.
ID de lugar do Google.
data_idstringAlias de feature_id.
ID de dados do Maps.
cidstringDerivado de feature_id se possível.
CID do Google.
kgmidstringQuando existe nos dados do Maps.
ID de máquina do grafo de conhecimento.
google_maps_urlstringQuando Google expõe uma URL do Maps.
URL do Google Maps.
urlstringgoogle_maps_url ou website como alternativa.
URL principal do lugar.
ratingnumberQuando há avaliação.
Avaliação do Google.
typesstring[]Quando há categorias.
Rótulos de tipo de lugar.
categoryobjectQuando a categoria é analisada.
Dados estruturados de categoria.
addressstringQuando há endereço.
Endereço formatado.
address_componentsobjectQuando há componentes.
Rua, cidade, código postal e país.
plus_codeobjectQuando há Plus Code.
Plus Codes globais e compostos.
phonestringQuando há telefone.
Número local.
phone_internationalstringQuando existe.
Número internacional.
phone_uristringQuando existe.
URI de telefone.
websitestringQuando há site.
Site do estabelecimento.
website_domainstringQuando há domínio do site.
Domínio do site do estabelecimento.
latitudenumberQuando há coordenadas.
Latitude.
longitudenumberQuando há coordenadas.
Longitude.
imagestringQuando há imagem.
Imagem principal do lugar.
thumbnailstringAlias de image, se existir.
Alias da imagem principal.
photosMapsPhoto[]Quando fotos são analisadas.
ID, URL, tamanho e coordenadas opcionais da foto.
hoursRecord<string,string>Quando horários são analisados.
Horário por dia.
open_statusobjectQuando há status.
Status de abertura e horário atual.
attributesobject[]Quando atributos são analisados.
Atributos agrupados do lugar.
related_placesobject[]Quando há lugares relacionados.
Lugares relacionados do Maps.
short_descriptionstringQuando há descrição.
Descrição breve do lugar.
descriptionstringQuando há descrição.
Descrição extensa do lugar.
snippetstringshort_description ou description como alternativa.
Resumo normalizado.
timezonestringQuando existe.
Fuso horário do lugar.
regionstringQuando existe.
Rótulo de região.
country_codestringQuando existe.
Código do país.
languagestringQuando existe.
Código de idioma do Maps.
curl -X POST 'https://api.serpbase.dev/google/maps/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"location":{"location_query":"Seattle, WA"},"query":"coffee"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/maps/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "coffee",
"hl": "en",
"gl": "us",
"page": 1,
"lat": 37.7749,
"lng": -122.4194,
"zoom": 14
}'Descoberta local, lojas e auditorias geo.
Envie lat e lng juntos. zoom só é válido com coordenadas e o padrão é 14.
/google/maps/detailMaps Detail
Consulte um lugar do Google Maps por ID. Complementa a busca e tem seu próprio preço por solicitação.
Consulte um lugar do Google Maps por ID. Complementa a busca e tem seu próprio preço por solicitação.
feature_idstringobrigatorio
Use o campo feature_id retornado pelos resultados de local do Maps Search. O formato e 0x...:0x....
hlstringopcional
Codigo de idioma. Padrao: en.
glstringopcional
Codigo do pais. Padrao: us.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "ChIJVVVVVYxK1EARyQpK5cQqEAA"
{
"id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}feature_idstringobrigatorio
feature_id resolvido da solicitação de detalhes.
pagenumberobrigatorio
Sempre 1 para detalhes do Maps.
placeMapsPlaceQuando detalhes do lugar são analisados.
Objeto de detalhes de um lugar.
positionnumberSomente Maps Search.
Posição do lugar nos resultados locais.
namestringobrigatorio
Nome do lugar.
titlestringobrigatorio
Alias de name.
feature_idstringobrigatorio
ID de elemento do Google Maps.
place_idstringQuando Google o expõe.
ID de lugar do Google.
data_idstringAlias de feature_id.
ID de dados do Maps.
cidstringDerivado de feature_id se possível.
CID do Google.
kgmidstringQuando existe nos dados do Maps.
ID de máquina do grafo de conhecimento.
google_maps_urlstringQuando Google expõe uma URL do Maps.
URL do Google Maps.
urlstringgoogle_maps_url ou website como alternativa.
URL principal do lugar.
ratingnumberQuando há avaliação.
Avaliação do Google.
typesstring[]Quando há categorias.
Rótulos de tipo de lugar.
categoryobjectQuando a categoria é analisada.
Dados estruturados de categoria.
addressstringQuando há endereço.
Endereço formatado.
address_componentsobjectQuando há componentes.
Rua, cidade, código postal e país.
plus_codeobjectQuando há Plus Code.
Plus Codes globais e compostos.
phonestringQuando há telefone.
Número local.
phone_internationalstringQuando existe.
Número internacional.
phone_uristringQuando existe.
URI de telefone.
websitestringQuando há site.
Site do estabelecimento.
website_domainstringQuando há domínio do site.
Domínio do site do estabelecimento.
latitudenumberQuando há coordenadas.
Latitude.
longitudenumberQuando há coordenadas.
Longitude.
imagestringQuando há imagem.
Imagem principal do lugar.
thumbnailstringAlias de image, se existir.
Alias da imagem principal.
photosMapsPhoto[]Quando fotos são analisadas.
ID, URL, tamanho e coordenadas opcionais da foto.
hoursRecord<string,string>Quando horários são analisados.
Horário por dia.
open_statusobjectQuando há status.
Status de abertura e horário atual.
attributesobject[]Quando atributos são analisados.
Atributos agrupados do lugar.
related_placesobject[]Quando há lugares relacionados.
Lugares relacionados do Maps.
short_descriptionstringQuando há descrição.
Descrição breve do lugar.
descriptionstringQuando há descrição.
Descrição extensa do lugar.
snippetstringshort_description ou description como alternativa.
Resumo normalizado.
timezonestringQuando existe.
Fuso horário do lugar.
regionstringQuando existe.
Rótulo de região.
country_codestringQuando existe.
Código do país.
languagestringQuando existe.
Código de idioma do Maps.
curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'Exemplo existente do Google
curl -X POST https://api.serpbase.dev/google/maps/detail \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
"hl": "en",
"gl": "us"
}'Enriquecimento de locais, CRM local e detalhes.
Use feature_id do resultado de Maps Search para detalhes. Um feature_id válido mas desconhecido retorna status 1004.
/google/maps/reviewsGoogle Maps Reviews
Primeira página de avaliações do Google Maps de um local (por data_id): nota, texto, data, fotos e autor. Ainda não inclui respostas do proprietário.
Primeira página de avaliações do Google Maps de um local (por data_id): nota, texto, data, fotos e autor. Ainda não inclui respostas do proprietário.
data_idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
dataIDstringopcional
data_id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
next_page_tokenstringopcional
next_token: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
topic_idstringopcional
attributes.topic_id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/autocompleteGoogle Search Autocomplete
Obtenha sugestões do Google por prefixo; não são medições de volume de buscas.
Obtenha sugestões do Google por prefixo; não são medições de volume de buscas.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "weather"
{
"query": "weather"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.autocomplete
curl -X POST 'https://api.serpbase.dev/google/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"weather"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/shoppingGoogle Shopping Search
Busque Google Shopping por consulta; é um retrato pontual, não monitoramento contínuo de preços.
Busque Google Shopping por consulta; é um retrato pontual, não monitoramento contínuo de preços.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee maker"
{
"query": "coffee maker"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.product_offers
curl -X POST 'https://api.serpbase.dev/google/shopping' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee maker"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/jobsGoogle Jobs Search
Busque vagas do Google por cargo ou palavra-chave; retorna as disponíveis, não envia candidaturas.
Busque vagas do Google por cargo ou palavra-chave; retorna as disponíveis, não envia candidaturas.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "software engineer"
{
"query": "software engineer"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.jobs
curl -X POST 'https://api.serpbase.dev/google/jobs' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"software engineer"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/scholarGoogle Scholar Search
Busque Google Scholar por tema ou palavra-chave; os metadados não garantem acesso ao texto completo.
Busque Google Scholar por tema ou palavra-chave; os metadados não garantem acesso ao texto completo.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "quantum computing"
{
"query": "quantum computing"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/scholar' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"quantum computing"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/booksGoogle Books Search
Busque Google Books por título, autor ou palavra-chave; não inclui downloads irrestritos.
Busque Google Books por título, autor ou palavra-chave; não inclui downloads irrestritos.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "clean code"
{
"query": "clean code"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/books' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"clean code"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/financeGoogle Finance Search
Consulte Google Finance por empresa ou termo financeiro; não é fluxo de mercado nem API de negociação.
Consulte Google Finance por empresa ou termo financeiro; não é fluxo de mercado nem API de negociação.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "apple stock"
{
"query": "apple stock"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/finance' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"apple stock"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/patents/detailGoogle Patent Details
Obtenha uma patente do Google Patents pelo número de publicação: título, resumo, reivindicações, inventores, titulares e datas.
Obtenha uma patente do Google Patents pelo número de publicação: título, resumo, reivindicações, inventores, titulares e datas.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "US8244737B2"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
lanaguagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
patent_idstringopcional
id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "US8244737B2"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/patents/detail' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"US8244737B2"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/play/searchGoogle Play Search
Pesquise apps no Google Play por palavra-chave; retorna nome, nome do pacote, ícone e link da loja. Não baixa apps.
Pesquise apps no Google Play por palavra-chave; retorna nome, nome do pacote, ícone e link da loja. Não baixa apps.
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee"
agestringopcional
attributes.age: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
store_devicestringopcional
attributes.store_device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"q": "coffee"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/play/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/play/appGoogle Play App Details
Obtenha um app do Google Play pelo nome do pacote: nome, desenvolvedor, descrição, preço, versão, datas de lançamento e classificação etária.
Obtenha um app do Google Play pelo nome do pacote: nome, desenvolvedor, descrição, preço, versão, datas de lançamento e classificação etária.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "com.spotify.music"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "com.spotify.music"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/play/app' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"com.spotify.music"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/trendsGoogle Trends
Google Trends: interesse ao longo do tempo, por região e pesquisas relacionadas para até cinco termos separados por vírgula.
Google Trends: interesse ao longo do tempo, por região e pesquisas relacionadas para até cinco termos separados por vírgula.
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee"
catstringopcional
category_id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
datestringopcional
time_range: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
geostringopcional
attributes.geo: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gpropstringopcional
attributes.gprop: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
include_low_search_volumestringopcional
attributes.include_low_search_volume: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
regionstringopcional
attributes.region: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
tzstringopcional
attributes.tz: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"q": "coffee"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/trends/autocompleteGoogle Trends Autocomplete
Sugestões de tópicos do Google Trends para uma palavra-chave, com tipo e identificador de cada tópico.
Sugestões de tópicos do Google Trends para uma palavra-chave, com tipo e identificador de cada tópico.
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"q": "coffee"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/google/trends/trendingGoogle Trends Trending Now
Pesquisas em alta agora no Google Trends para um país (EUA por padrão) nas últimas 24 horas.
Pesquisas em alta agora no Google Trends para um país (EUA por padrão) nas últimas 24 horas.
glstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "us"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
geostringopcional
attributes.geo: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
google_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
gooogle_domainstringopcional
locale.engine_domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hoursstringopcional
attributes.hours: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"gl": "us"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends/trending' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"gl":"us"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/bing/searchBing Web Search
Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.
Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.
Este endpoint está sendo ajustado e está pausado. Não pode ser chamado até ser reaberto.
glstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "us"
hlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "en"
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "artificial intelligence"
ccstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countstringopcional
attributes.count: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
firststringopcional
attributes.first: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
latstringopcional
attributes.lat: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
lonstringopcional
attributes.lon: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mktstringopcional
attributes.mkt: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
resultsstringopcional
attributes.results: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
safeSearchstringopcional
attributes.safeSearch: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"gl": "us",
"hl": "en",
"q": "artificial intelligence"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/duckduckgo/searchDuckDuckGo Search
Busque DuckDuckGo HTML com filtros aceitos de mercado e data. Continue com o cursor retornado, não páginas numeradas.
Busque DuckDuckGo HTML com filtros aceitos de mercado e data. Continue com o cursor retornado, não páginas numeradas.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee shops"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
dfstringopcional
attributes.df: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
klstringopcional
attributes.kl: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
next_page_tokenstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"query": "coffee shops"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/duckduckgo/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee shops"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/reddit/postReddit Post & Comments
Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/reddit/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/reddit/searchReddit Search
Search public Reddit posts and discussion threads across subreddits by keyword query.
Search public Reddit posts and discussion threads across subreddits by keyword query.
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "best mechanical keyboard"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"q": "best mechanical keyboard"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/reddit/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"best mechanical keyboard"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/tiktok/postTikTok Post
Consulte uma publicação TikTok por ID e usuário; não descobre todas as publicações do perfil.
Consulte uma publicação TikTok por ID e usuário; não descobre todas as publicações do perfil.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "7123456789012345678"
usernamestringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "tiktok"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
post_idstringopcional
id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "7123456789012345678",
"username": "tiktok"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"7123456789012345678","username":"tiktok"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/tiktok/profileTikTok Profile
Consulte um perfil TikTok por usuário. Depende do acesso à origem; não é um arquivo histórico de audiência.
Consulte um perfil TikTok por usuário. Depende do acesso à origem; não é um arquivo histórico de audiência.
usernamestringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "tiktok"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"username": "tiktok"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/profile' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"username":"tiktok"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/tiktok/searchTikTok Search
Pesquise vídeos do TikTok por palavra-chave: links, legendas, autores, visualizações, curtidas, comentários, compartilhamentos, hashtags e capas; 16 por página por padrão.
Pesquise vídeos do TikTok por palavra-chave: links, legendas, autores, visualizações, curtidas, comentários, compartilhamentos, hashtags e capas; 16 por página por padrão.
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "pasta recipe"
countintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
keywordstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
next_page_tokenstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"q": "pasta recipe"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"pasta recipe"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/x/postX Post Details
Consulte uma publicação X por ID; não é busca por palavras, exportação de linha do tempo nem streaming.
Consulte uma publicação X por ID; não é busca por palavras, exportação de linha do tempo nem streaming.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "1234567890123456789"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
tweetIdstringopcional
id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "1234567890123456789"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/x/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"1234567890123456789"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/youtube/searchYouTube Search
Search YouTube videos, Shorts, and creator channels with query and region parameters.
Search YouTube videos, Shorts, and creator channels with query and region parameters.
glstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "us"
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "nextjs tutorial"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
search_querystringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
spstringopcional
attributes.sp: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"gl": "us",
"q": "nextjs tutorial"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/youtube/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"gl":"us","q":"nextjs tutorial"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/youtube/transcriptsYouTube Video Transcripts
Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "dQw4w9WgXcQ"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
vstringopcional
id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
video_linkstringopcional
url: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "dQw4w9WgXcQ"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/youtube/transcripts' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"dQw4w9WgXcQ"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/ajio/productAjio Product Details
Consulta um produto AJIO pela URL HTTPS /p/; não exporta catálogos.
Consulta um produto AJIO pela URL HTTPS /p/; não exporta catálogos.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://www.ajio.com/sample/p/1234567890"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://www.ajio.com/sample/p/1234567890"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/ajio/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.ajio.com/sample/p/1234567890"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/amazon/productAmazon Product Details
Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
asinstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "B08N5WRWNW"
domainstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "amazon.com"
amazon_domainstringopcional
domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
typestringopcional
search_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"asin": "B08N5WRWNW",
"domain": "amazon.com"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/amazon/reviewsAmazon Product Reviews
Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
asinstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "B08N5WRWNW"
domainstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "amazon.com"
amazon_domainstringopcional
domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
filter_by_starstringopcional
review_rating: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
reviewer_typestringopcional
review_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
typestringopcional
search_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"asin": "B08N5WRWNW",
"domain": "amazon.com"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/reviews' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/amazon/searchAmazon Product Search
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
domainstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "amazon.com"
qstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "wireless headphones"
amazon_domainstringopcional
domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
typestringopcional
search_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"domain": "amazon.com",
"q": "wireless headphones"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"amazon.com","q":"wireless headphones"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/amazon/autocompleteAmazon Search Autocomplete
Obtenha sugestões da Amazon por prefixo, não detalhes nem histórico de preços.
Obtenha sugestões da Amazon por prefixo, não detalhes nem histórico de preços.
prefixstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "laptop"
amazon_domainstringopcional
domain: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
midstringopcional
marketplace_id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
typestringopcional
search_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"prefix": "laptop"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"prefix":"laptop"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/apple/productApple Product Details
Consulte apps da App Store por ID numérico ou URL apps.apple.com e país; não hardware Apple.
Consulte apps da App Store por ID numérico ou URL apps.apple.com e país; não hardware Apple.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "284882215"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
product_idstringopcional
id: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
typestringopcional
search_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "284882215"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/apple/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"284882215"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/ebay/producteBay Product Details
Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
domainstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "ebay.com"
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "123456789012"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"domain": "ebay.com",
"id": "123456789012"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/ebay/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"ebay.com","id":"123456789012"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/ebay/searcheBay Product Search
Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
domainstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "ebay.com"
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "vintage watch"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"domain": "ebay.com",
"query": "vintage watch"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/ebay/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"ebay.com","query":"vintage watch"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/flipkart/productFlipkart Product Details
Consulte Flipkart por URL de produto com /p/. Use uma URL específica, não uma busca.
Consulte Flipkart por URL de produto com /p/. Use uma URL específica, não uma busca.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://www.flipkart.com/item/p/itm1234567890"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://www.flipkart.com/item/p/itm1234567890"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/flipkart/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.flipkart.com/item/p/itm1234567890"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/myntra/productMyntra Product Details
Consulte um produto Myntra por URL /buy; é separado da busca.
Consulte um produto Myntra por URL /buy; é separado da busca.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://www.myntra.com/shoes/nike/123456/buy"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://www.myntra.com/shoes/nike/123456/buy"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/myntra/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.myntra.com/shoes/nike/123456/buy"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/myntra/searchMyntra Search
Busque Myntra por consulta ou URL aceita. Aceita páginas numeradas, não cursores nem alterações de tamanho da página.
Busque Myntra por consulta ou URL aceita. Aceita páginas numeradas, não cursores nem alterações de tamanho da página.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "shoes"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"query": "shoes"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/myntra/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"shoes"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/walmart/productWalmart Product Details
Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
idstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "133497934"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"id": "133497934"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"133497934"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/walmart/searchWalmart Product Search
Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "coffee maker"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"query": "coffee maker"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee maker"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/walmart/autocompleteWalmart Search Autocomplete
Obtenha sugestões do Walmart por consulta; não consulta páginas de produtos.
Obtenha sugestões do Walmart por consulta; não consulta páginas de produtos.
querystringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "laptop"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"query": "laptop"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"laptop"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/web/user-agentUser-Agent Generator
Gere UA de desktop ou móvel com user_agent_type e user_agent_count (1–5). A operação local também tem preço de catálogo.
Gere UA de desktop ou móvel com user_agent_type e user_agent_count (1–5). A operação local também tem preço de catálogo.
user_agent_countnumberExemplo do catálogo; a API valida campos obrigatórios.
exemplo: 1
user_agent_typestringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "desktop"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
uanumintegeropcional
user_agent_count: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
uatypestringopcional
user_agent_type: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"user_agent_count": 1,
"user_agent_type": "desktop"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/user-agent' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"user_agent_count":1,"user_agent_type":"desktop"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/web/crawlWeb Crawl
Inicie rastreamento limitado por URL pública. Preço fixo por solicitação, não multiplicado pelas páginas retornadas.
Inicie rastreamento limitado por URL pública. Preço fixo por solicitação, não multiplicado pelas páginas retornadas.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://example.com"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://example.com"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/crawl' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://example.com"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/web/scrapeWeb Scrape
Extraia páginas públicas HTTP/HTTPS por URL com texto, HTML, Markdown e seletores; aplicam-se restrições da origem. Páginas do Google não são suportadas; use os endpoints do Google, como /google/search.
Extraia páginas públicas HTTP/HTTPS por URL com texto, HTML, Markdown e seletores; aplicam-se restrições da origem. Páginas do Google não são suportadas; use os endpoints do Google, como /google/search.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://example.com"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
custom_headersobjectopcional
headers: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://example.com"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/scrape' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://example.com"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
/zillow/searchZillow Property Search
Consulte Zillow por URL homes aceita. É um retrato dos anúncios, não avaliações nem fluxo de transações.
Consulte Zillow por URL homes aceita. É um retrato dos anúncios, não avaliações nem fluxo de transações.
urlstringExemplo do catálogo; a API valida campos obrigatórios.
exemplo: "https://www.zillow.com/homes/Seattle-WA_rb/"
countrystringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
cursorstringopcional
pagination.cursor: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
devicestringopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
glstringopcional
locale.country: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
hlstringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
htmlbooleanopcional
include_html: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
languagestringopcional
locale.language: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
limitintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
markdownbooleanopcional
include_markdown: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
mobilebooleanopcional
options.device: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
numintegeropcional
pagination.limit: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
pageintegeropcional
pagination.page: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
qstringopcional
query: Aliases de parâmetros: use uma forma por vez. A API valida parâmetros e valores aceitos.
{
"url": "https://www.zillow.com/homes/Seattle-WA_rb/"
}A resposta segue o contrato do produto; ainda não há exemplo registrado publicado.schemas.source_data
curl -X POST 'https://api.serpbase.dev/zillow/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.zillow.com/homes/Seattle-WA_rb/"}'Comece com o exemplo do catálogo e confira o JSON real.
O exemplo não é o contrato completo. Campos conhecidos são validados e parâmetros adicionais são permitidos.
errorstringobrigatorio
Mensagem de erro legivel.
Solicitação concluída. Verifique campos do produto; no_results não prova HTTP 404.
Cobrado
Corpo ou parâmetros ausentes ou inválidos.
Sem cobrançaCorrija a solicitação antes
Chave ausente, inválida ou revogada.
Sem cobrançaCorrija a solicitação antes
Recurso não encontrado nas rotas ou catálogo do gateway.
Sem cobrançaCorrija a solicitação antes
Saldo insuficiente.
Sem cobrançaCorrija a solicitação antes
Limite QPS ou de concorrência excedido.
Sem cobrançaPode repetir
Erro interno inesperado.
Sem cobrançaPode repetir
O worker retornou erro de obtenção ou análise da origem.
Sem cobrançaPode repetir
Não há sessão de worker disponível.
Sem cobrançaPode repetir
O gateway excedeu o tempo esperando pelo worker.
Sem cobrançaPode repetir
{
"status": 1001,
"error": "unauthorized",
"request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
"elapsed_ms": 0,
"credits_charged": 0
}Cada resposta traz estes cabeçalhos para que seu cliente controle o ritmo e decida se repete sem analisar a mensagem.
- X-RateLimit-Limit
- Solicitações por segundo permitidas na sua conta.
- X-RateLimit-Remaining
- Solicitações ainda permitidas no segundo atual.
- Retry-After
- Se recusada, segundos a esperar antes de reenviar.
- X-SerpBase-Retryable
- true se reenviar a mesma solicitação pode funcionar; false se ela precisa mudar.