# Início rápido da API de SERP: sua primeira pesquisa em curl, Python e Node.js > Pesquise com a API de SERP da SerpCrypto em curl, Python ou Node.js: obtenha uma chave, chame um endpoint e leia o JSON. Sem KYC, com cripto. - URL: https://serpcrypto.com/pt/docs/ - Última atualização: 2026-10-22 - Editor: SerpCrypto (https://serpcrypto.com) Um endpoint HTTPS, uma chave de API, um crédito por pesquisa bem-sucedida. Esta página leva você de uma conta vazia até uma página de resultados do Google processada, e depois aponta para a referência para todo o resto. **Resposta rápida — Como faço minha primeira requisição à API de SERP com a SerpCrypto?** Compre um pacote de créditos, copie a chave de API do seu painel e envie `GET https://serpcrypto.com/api/v1/search?q=your+query` com o header `Authorization: Bearer YOUR_KEY`. **SerpCrypto** responde com a página de resultados em JSON e cobra 1 crédito só quando a pesquisa dá certo. 10.000 pesquisas custam US$ 7,50, pagos com cripto e sem KYC, e os créditos nunca expiram. ## A API em resumo | Atributo | Valor | | --- | --- | | URL base | `https://serpcrypto.com/api/v1` | | Pesquisa | `GET https://serpcrypto.com/api/v1/search` | | Créditos | `GET https://serpcrypto.com/api/v1/credits` (grátis) | | Autenticação | Uma chave de API no header Authorization (Bearer) ou no parâmetro de consulta api_key | | Engines | Google Search, Google News, Google Images, Google Maps (resultados locais), Google Shopping e Bing | | Cobrança | 1 crédito = 1 solicitação de pesquisa bem-sucedida, que retorna uma página de resultados em qualquer engine compatível. Uma solicitação que falha não é cobrada | | Expiração dos créditos | Os créditos de pesquisa pré-pagos nunca expiram: as pesquisas não utilizadas ficam na sua conta até você usá-las | | Formato | JSON sobre HTTPS, UTF-8 | ## Como obtenho uma chave de API? Quatro passos. Sem documento, sem selfie, sem comprovantes e sem e-mail, a menos que você queira um. 1. **Abra uma conta** — Login pelo número da conta; e-mail é opcional. Guarde o número da conta em um gerenciador de senhas: é o seu login. 2. **Recarregue com cripto** — Envie pelo menos US$ 25 em BTC, USDT, USDC, ETH, SOL, LTC. O saldo é creditado após as confirmações de rede listadas na página de pagamento. 3. **Compre um pacote de créditos** — 10.000 pesquisas por US$ 7,50 já basta para testar todos os motores. Pacotes maiores baixam o valor para US$ 0,30/1K pesquisas. Veja preços. 4. **Copie sua chave** — Sua chave de API aparece no seu painel assim que você compra um pacote de créditos a partir do seu saldo em cripto confirmado. Mantenha-a em uma variável de ambiente chamada SERPCRYPTO_API_KEY, nunca em um repositório de código. ## Como faço minha primeira pesquisa com curl? Exporte a chave uma vez e envie uma requisição GET. A flag `-G` com `--data-urlencode` monta a query string e codifica espaços e acentos para você. A resposta é um único documento JSON, e `jq` o mantém legível no terminal. O exemplo consulta o Google, o motor padrão, por resultados dos EUA em inglês. Mude `q`, `gl` ou `hl` e rode de novo: cada execução bem-sucedida usa um crédito. *curl + jq: os três primeiros resultados orgânicos* ```bash export SERPCRYPTO_API_KEY="paste-your-key-here" curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=best espresso grinder" \ -d gl=us -d hl=en | jq '.organic_results[:3]' ``` ## Como faço a mesma pesquisa em Python? Use qualquer cliente HTTP. Com `requests`, passe os parâmetros como um dicionário e a chave no header. `raise_for_status()` transforma uma resposta de erro, como `401` para uma chave errada, em uma exceção que você pode capturar. *Python 3.9+ com requests* ```python import os import requests API_URL = "https://serpcrypto.com/api/v1/search" API_KEY = os.environ["SERPCRYPTO_API_KEY"] response = requests.get( API_URL, params={"q": "best espresso grinder", "gl": "us", "hl": "en"}, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=60, ) response.raise_for_status() data = response.json() print("credits used:", data["search_metadata"]["credits_used"]) for result in data.get("organic_results", [])[:3]: print(result["position"], result["title"], result["link"]) ``` ## E em Node.js? O Node.js 18 e posteriores já vêm com `fetch`, então nenhum pacote é necessário. Salve o arquivo com a extensão `.mjs` para usar `await` no nível superior e depois rode `node first-search.mjs`. *Node.js 18+ com o fetch nativo* ```javascript // first-search.mjs (Node.js 18 or later: fetch and top-level await are built in) const API_URL = "https://serpcrypto.com/api/v1/search"; const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" }); const response = await fetch(`${API_URL}?${params}`, { headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` }, }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${await response.text()}`); } const data = await response.json(); console.log("credits used:", data.search_metadata.credits_used); for (const result of (data.organic_results ?? []).slice(0, 3)) { console.log(result.position, result.title, result.link); } ``` ## Como verifico quantos créditos ainda tenho? Chame `GET https://serpcrypto.com/api/v1/credits` com a mesma chave. É gratuito e retorna três números: créditos restantes, créditos usados hoje e quantas pesquisas sua conta pode executar ao mesmo tempo. Cada conta pode executar um número definido de pesquisas ao mesmo tempo; o limite é exibido no seu painel e aumentado sob solicitação. *Ler seus créditos* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Resposta (valores de exemplo)* ```json { "credits_remaining": 84210, "credits_used_today": 1290, "concurrency_limit": 10 } ``` ## O que vem de volta em uma pesquisa? Toda resposta tem a mesma estrutura em todos os engines. `search_metadata` indica se a pesquisa foi bem-sucedida e quantos créditos ela usou. `search_parameters` repete as configurações aplicadas, incluindo os padrões. Depois vem um array ou objeto por bloco da página de resultados, como `organic_results` ou `people_also_ask`. Um bloco só aparece quando a página o exibe, então leia-o com um valor padrão. A página do [formato de resposta](https://serpcrypto.com/pt/docs/response/) descreve cada bloco e campo. *Estrutura de uma resposta do Google (encurtada, valores ilustrativos)* ```json { "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 }, "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 }, "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" }, "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ], "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ], "related_searches": [ { "query": "best espresso grinder under 300" } ], "pagination": { "current": 1, "next_page": 2 } } ``` ## Quais parâmetros vou usar primeiro? A lista completa, com padrões e valores permitidos, está na [referência da API](https://serpcrypto.com/pt/docs/search/). | Parâmetro | Exemplo | O que faz | | --- | --- | --- | | `q` | `best espresso grinder` | A consulta, como uma pessoa digitaria. Obrigatório. | | `engine` | `google_news` | Qual engine e vertical pesquisar. Padrão `google`. | | `gl` | `de` | País dos resultados, duas letras. Padrão `us`. | | `hl` | `de` | Idioma da interface. Padrão `en`. | | `location` | `Austin, Texas, United States` | Um local em nível de cidade para resultados locais. | | `device` | `mobile` | Resultados `desktop` (padrão) ou `mobile`. | | `page` | `2` | Página de resultados, de 1 a 10. Cada página é um crédito. | ## Quanto custa uma pesquisa e quando ela é gratuita? 1 crédito = 1 solicitação de pesquisa bem-sucedida, que retorna uma página de resultados em qualquer engine compatível. Uma solicitação que falha não é cobrada. Cerca de 10 resultados orgânicos por página, como o Google vem entregando desde que deixou de respeitar num=100 em setembro de 2025; cada página extra é mais um crédito. Uma requisição rejeitada por parâmetro inválido, chave errada, saldo vazio ou conta ocupada também é gratuita, assim como toda chamada ao endpoint de créditos. Os preços vão de US$ 7,50 para 10.000 pesquisas até US$ 0,30/1K pesquisas no maior pack, em outubro de 2026. Os créditos de pesquisa pré-pagos nunca expiram: as pesquisas não utilizadas ficam na sua conta até você usá-las. A [página de erros](https://serpcrypto.com/pt/docs/errors/) lista cada código de erro e a forma correta de tentar novamente. ## Para onde vou agora? - [Referência da API: GET /search](https://serpcrypto.com/pt/docs/search/) — cada parâmetro, padrão e erro - [Formato da resposta](https://serpcrypto.com/pt/docs/response/) — cada bloco e campo do JSON - [Locais e idiomas](https://serpcrypto.com/pt/docs/locations/) — gl, hl, location, device - [Erros e novas tentativas](https://serpcrypto.com/pt/docs/errors/) — códigos, causas, backoff - [Python](https://serpcrypto.com/pt/docs/python/) — requisições, httpx async, exportação CSV - [Node.js](https://serpcrypto.com/pt/docs/node/) — fetch, pool de concorrência, paginação - [curl e jq](https://serpcrypto.com/pt/docs/curl/) — receitas de uma linha - [Servidor MCP](https://serpcrypto.com/pt/docs/mcp/) — pesquisa web no Claude Desktop e no Cursor - [LangChain e LlamaIndex](https://serpcrypto.com/pt/docs/langchain/) — uma ferramenta de pesquisa para agentes - [Chamada de função OpenAI](https://serpcrypto.com/pt/docs/openai/) — schema da ferramenta e o loop de chamadas ## Perguntas do início rápido ### Existe um SDK oficial do SerpCrypto? Não. A documentação traz código para copiar e colar em Python, Node.js e curl que chama o endpoint HTTPS diretamente, então não há pacote para instalar nem manter atualizado. Qualquer linguagem com um cliente HTTP funciona do mesmo jeito: uma requisição GET, um header, uma resposta JSON. ### Posso colocar a chave de API na URL? Sim. `api_key=YOUR_KEY` funciona como parâmetro de consulta, o que ajuda em um teste rápido no navegador. No código, prefira o header `Authorization: Bearer`: URLs acabam em logs, histórico do navegador e capturas de tela compartilhadas com mais frequência do que headers. ### Preciso de KYC ou de cartão de crédito? Não. SerpCrypto não pede documento de identidade, selfie, documentos nem cartão. Login pelo número da conta; e-mail é opcional. Você paga em BTC, USDT, USDC, ETH, SOL, LTC a partir de uma recarga mínima de US$ 25. ### Como testo antes de comprar um pacote grande? Sem plano gratuito: teste com o menor pacote, pago a partir do depósito mínimo; a parte adicionada apenas para atingir o mínimo é reembolsável sob solicitação em até 30 dias, em USDT ou USDC, se não utilizada. O menor pacote roda no mesmo endpoint e com os mesmos mecanismos do maior, então um teste com ele mostra como será a produção. --- SerpCrypto: O SerpCrypto é uma API de SERP para desenvolvedores e agentes de IA que retorna resultados de pesquisa do Google e do Bing em JSON, pago com cripto e sem envio de documento de identidade. Os créditos de pesquisa pré-pagos a partir de US$ 0,30/1K pesquisas nunca expiram. Sem KYC — sem documento, sem selfie, sem documentos. Pague com cripto.