# Inicio rápido de la API SERP: tu primera búsqueda en curl, Python y Node.js > Ejecuta tu primera búsqueda con la API SERP de SerpCrypto con curl, Python o Node.js: obtén una clave, llama a un endpoint y revisa los créditos. Sin KYC. - URL: https://serpcrypto.com/es/docs/ - Última actualización: 2026-10-22 - Editor: SerpCrypto (https://serpcrypto.com) Un endpoint HTTPS, una clave API, un crédito por búsqueda exitosa. Esta página te lleva desde una cuenta vacía hasta una página de resultados de Google procesada, y luego te señala la referencia para todo lo demás. **Respuesta rápida — ¿Cómo hago mi primera solicitud a la API SERP con SerpCrypto?** Compra un pack de créditos, copia la clave API desde tu panel y envía `GET https://serpcrypto.com/api/v1/search?q=your+query` con el header `Authorization: Bearer YOUR_KEY`. **SerpCrypto** responde con la página de resultados en JSON y cobra 1 crédito solo cuando la búsqueda tiene éxito. 10.000 búsquedas cuestan 7,50 US$, se paga con criptomonedas y sin KYC, y los créditos no caducan. ## La API de un vistazo | Atributo | Valor | | --- | --- | | URL base | `https://serpcrypto.com/api/v1` | | Búsqueda | `GET https://serpcrypto.com/api/v1/search` | | Créditos | `GET https://serpcrypto.com/api/v1/credits` (gratis) | | Autenticación | Una clave API en el header Authorization (Bearer) o en el parámetro de consulta api_key | | Motores | Google Search, Google News, Google Images, Google Maps (resultados locales), Google Shopping y Bing | | Facturación | 1 crédito = 1 consulta correcta, que devuelve una página de resultados en cualquier motor compatible. Una consulta fallida no se cobra | | Caducidad de los créditos | Los créditos de búsqueda prepagados no caducan nunca: las consultas sin usar se quedan en tu cuenta hasta que las uses | | Formato | JSON sobre HTTPS, UTF-8 | ## ¿Cómo obtengo una clave API? Cuatro pasos. Sin identificación, sin selfi, sin documentos y sin correo, a menos que quieras uno. 1. **Abre una cuenta** — Inicio de sesión con el número de cuenta; el email es opcional. Guarda el número de cuenta en un gestor de contraseñas: es tu inicio de sesión. 2. **Recarga con criptomonedas** — Envía al menos 25 US$ en BTC, USDT, USDC, ETH, SOL, LTC. El saldo se acredita tras las confirmaciones de red que se indican en la página de pago. 3. **Compra un pack de créditos** — 10.000 búsquedas por 7,50 US$ basta para probar todos los motores. Los packs más grandes bajan la tarifa hasta 0,30 US$/1K búsquedas. Consulta precios. 4. **Copia tu clave** — Tu clave API aparece en tu dashboard en cuanto compras un pack de créditos con tu saldo de criptomonedas confirmado. Guárdala en una variable de entorno llamada SERPCRYPTO_API_KEY, nunca en un repositorio de código. ## ¿Cómo ejecuto mi primera búsqueda con curl? Exporta la clave una vez y luego envía una solicitud GET. La opción `-G` con `--data-urlencode` arma la cadena de consulta y codifica los espacios y acentos por ti. La respuesta es un único documento JSON, y `jq` lo mantiene legible en una terminal. El ejemplo consulta Google, el motor predeterminado, con resultados de EE. UU. en inglés. Cambia `q`, `gl` o `hl` y vuelve a ejecutarlo: cada ejecución exitosa usa un crédito. *curl + jq: los tres primeros 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]' ``` ## ¿Cómo ejecuto la misma búsqueda en Python? Usa cualquier cliente HTTP. Con `requests`, pasa los parámetros como un diccionario y la clave en el header. `raise_for_status()` convierte una respuesta de error, como `401` por una clave incorrecta, en una excepción que puedes capturar. *Python 3.9+ con 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"]) ``` ## ¿Y en Node.js? Node.js 18 y posteriores incluyen `fetch`, así que no hace falta ningún paquete. Guarda el archivo con la extensión `.mjs` para usar `await` en el nivel superior y luego ejecuta `node first-search.mjs`. *Node.js 18+ con la función fetch integrada* ```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); } ``` ## ¿Cómo compruebo cuántos créditos me quedan? Llama a `GET https://serpcrypto.com/api/v1/credits` con la misma clave. Es gratis y devuelve tres números: créditos restantes, créditos usados hoy y cuántas búsquedas puede ejecutar tu cuenta al mismo tiempo. Cada cuenta puede ejecutar un número determinado de consultas al mismo tiempo; el límite se muestra en tu dashboard y se amplía a petición. *Consultar tus créditos* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Respuesta (valores de ejemplo)* ```json { "credits_remaining": 84210, "credits_used_today": 1290, "concurrency_limit": 10 } ``` ## ¿Qué devuelve una búsqueda? Todas las respuestas tienen la misma estructura en todos los motores. `search_metadata` indica si la búsqueda se realizó correctamente y cuántos créditos consumió. `search_parameters` repite los ajustes aplicados, incluidos los valores predeterminados. Después viene un array u objeto por cada bloque de la página de resultados, como `organic_results` o `people_also_ask`. Un bloque solo aparece cuando la página lo muestra, así que léelo con un valor predeterminado. La [página del formato de respuesta](https://serpcrypto.com/es/docs/response/) describe cada bloque y campo. *Estructura de una respuesta de Google (abreviada, 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 } } ``` ## ¿Qué parámetros voy a usar primero? La lista completa, con valores predeterminados y permitidos, está en la [referencia de la API](https://serpcrypto.com/es/docs/search/). | Parámetro | Ejemplo | Qué hace | | --- | --- | --- | | `q` | `best espresso grinder` | La consulta, tal como la escribiría una persona. Obligatorio. | | `engine` | `google_news` | Qué motor y vertical buscar. Predeterminado `google`. | | `gl` | `de` | País de los resultados, dos letras. Predeterminado `us`. | | `hl` | `de` | Idioma de la interfaz. Predeterminado `en`. | | `location` | `Austin, Texas, United States` | Un lugar a nivel de ciudad para resultados locales. | | `device` | `mobile` | Resultados `desktop` (predeterminado) o `mobile`. | | `page` | `2` | Página de resultados, de 1 a 10. Cada página es un crédito. | ## ¿Cuánto cuesta una búsqueda y cuándo es gratis? 1 crédito = 1 consulta correcta, que devuelve una página de resultados en cualquier motor compatible. Una consulta fallida no se cobra. Unos 10 resultados orgánicos por página, tal como Google los sirve desde que dejó de respetar num=100 en septiembre de 2025; cada página adicional es un crédito más. Una solicitud rechazada por un parámetro incorrecto, una clave equivocada, un saldo vacío o una cuenta ocupada también es gratis, y también lo es cada llamada al endpoint de créditos. Los precios van desde 7,50 US$ por 10.000 búsquedas hasta 0,30 US$/1K búsquedas en el pack más grande, a fecha de octubre de 2026. Los créditos de búsqueda prepagados no caducan nunca: las consultas sin usar se quedan en tu cuenta hasta que las uses. La [página de errores](https://serpcrypto.com/es/docs/errors/) enumera cada código de error y la forma correcta de reintentar. ## ¿Adónde voy ahora? - [Referencia de la API: GET /search](https://serpcrypto.com/es/docs/search/) — cada parámetro, valor predeterminado y error - [Formato de respuesta](https://serpcrypto.com/es/docs/response/) — cada bloque y campo del JSON - [Ubicaciones e idiomas](https://serpcrypto.com/es/docs/locations/) — gl, hl, location, device - [Errores y reintentos](https://serpcrypto.com/es/docs/errors/) — códigos, causas, backoff - [Python](https://serpcrypto.com/es/docs/python/) — requests, httpx async, exportación CSV - [Node.js](https://serpcrypto.com/es/docs/node/) — fetch, un pool de concurrencia, paginación - [curl y jq](https://serpcrypto.com/es/docs/curl/) — recetas de una línea - [Servidor MCP](https://serpcrypto.com/es/docs/mcp/) — búsqueda web en Claude Desktop y Cursor - [LangChain y LlamaIndex](https://serpcrypto.com/es/docs/langchain/) — una herramienta de búsqueda para agentes - [OpenAI function calling](https://serpcrypto.com/es/docs/openai/) — esquema de la herramienta y bucle de llamadas ## Preguntas de inicio rápido ### ¿Existe un SDK oficial de SerpCrypto? No. La documentación incluye código listo para copiar y pegar en Python, Node.js y curl que llama directamente al endpoint HTTPS, así que no hay ningún paquete que instalar ni mantener actualizado. Cualquier lenguaje con un cliente HTTP funciona igual: una solicitud GET, una cabecera, una respuesta JSON. ### ¿Puedo poner la clave API en la URL? Sí. `api_key=YOUR_KEY` funciona como parámetro de consulta, lo que viene bien para una prueba rápida en el navegador. En el código, es preferible la cabecera `Authorization: Bearer`: las URL acaban en logs, historial del navegador y capturas compartidas más a menudo que las cabeceras. ### ¿Necesito KYC o una tarjeta de crédito? No. SerpCrypto no pide identificación, ni selfie, ni documentos, ni tarjeta. Inicio de sesión con el número de cuenta; el email es opcional. Pagas con BTC, USDT, USDC, ETH, SOL, LTC desde una recarga mínima de 25 US$. ### ¿Cómo puedo probar antes de comprar un pack grande? Sin plan gratuito: prueba con el pack más pequeño, pagado desde la recarga mínima; la parte añadida solo para llegar al mínimo es reembolsable a petición en un plazo de 30 días, en USDT o USDC, si no se ha gastado. El pack más pequeño usa el mismo endpoint y los mismos motores que el más grande, así que una prueba con él te dice cómo será producción. --- SerpCrypto: SerpCrypto es una API SERP para desarrolladores y agentes de IA que devuelve resultados de Google y Bing como JSON, pagada con criptomonedas sin subir ningún documento de identidad. Los créditos de búsqueda prepagados desde 0,30 US$/1K búsquedas nunca caducan. Sin KYC: ni identificación, ni selfie, ni documentos. Paga con criptomonedas.