Documentación de la API

Un endpoint y un campo op. Todos los endpoints comparten la misma forma de petición.

Inicio rápido

¿Quieres ver primero qué devuelve? Prueba el Playground. No hace falta leer esta página antes.

Regístrate para obtener una clave (el plan gratuito incluye 100 créditos) y luego:

curl -X POST https://widefetch.com/v1/call \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"google.search","params":{"keyword":"vector database"}}'

Autenticación

Authorization: Bearer sk_…. Las claves se emiten en la consola y solo se muestran completas una vez; guardamos un hash.

La revocación es inmediata. Si una clave se filtra, revócala y emite otra.

Hacer una llamada

POST /v1/call

Campo	Tipo	Descripción
op	string	El endpoint a llamar; consulta la tabla de abajo
params	object	Parámetros de ese endpoint

Síncrono con límite: las llamadas que terminan en unos 25 segundos devuelven el resultado directamente. Las más largas devuelven status: "running" y un request_id para consultar. Los endpoints basados en navegador (executor: browser) tardan más a menudo; los http y api suelen responder en uno o dos segundos.

{
  "request_id": "req_7Qn1vK…",
  "status": "done",          // done | running | failed
  "outcome": "ok",
  "credits_charged": 1,      // 0 when the call failed
  "timing": {
    "queued_ms": 400,
    "ran_ms": 8100,
    "attempts": 1            // >1 means it was retried
  },
  "result": { "items": [ … ] }
}

Sondeo

GET /v1/requests/{request_id}

Misma forma de respuesta que arriba. Consulta cada 2 segundos y ve espaciando hasta 5.

Reglas de facturación

Las llamadas fallidas son gratis. Captchas, límites de tasa, timeouts y respuestas sin mapear corren de nuestra cuenta y se reembolsan automáticamente.
Los resultados vacíos se cobran. "No se encontró nada" es una respuesta, no un fallo, y el coste ya se produjo.

Outcomes que se cobran

no_resultsokverified_page

Outcomes gratuitos

bad_paramscancelledcaptchaclaim_timeoutneeds_mappingnot_configuredrate_limitedtimeouttransient

Cualquier outcome no listado es gratis. Cobrar por defecto convertiría nuestros fallos en tu factura.

Endpoints

op	credit	Parámetros	Descripción
brave.search	1	keyword*, limit, region, language	Resultados de búsqueda web: título, URL y fragmento. Rápido y pensado para muchas llamadas en paralelo.	Probar
github.repo	1	repo*	Un repositorio de GitHub: estrellas, forks, issues abiertos, lenguaje, licencia y temas.	Probar
github.search	1	query*, sort, order, limit	Búsqueda de repositorios de GitHub, ordenada por estrellas, forks o última actualización.	Probar
google.search	1	keyword*, limit, language, region	Resultados orgánicos de Google: título, URL, dominio de origen y fragmento.	Probar
google.trends	1	keyword*, region	Interés de búsqueda en Google Trends: serie semanal de los últimos dos años (0–100).	Probar
hn.comments	1	keyword*, limit, sort, since	Búsqueda de comentarios de Hacker News: texto original, autor e historia de origen.	Probar
hn.item	1	id*, comments	Un hilo completo de Hacker News: el texto de la publicación y sus comentarios.	Probar
hn.search	1	keyword*, limit, sort, since, min_points	Historias de Hacker News: título, enlace, autor, puntos, número de comentarios y fecha.	Probar

Códigos de error

Código	Significado	Qué hacer
400	Parámetros no válidos u op desconocido	Corrige la petición. No se cobra.
401	Clave incorrecta o revocada	Usa otra clave
402	Sin créditos	Cambia de plan o espera a la renovación mensual
403	La lista de permitidos de esta clave no incluye el op	Revisa el campo `error` de la respuesta
429	Límite de tasa o de concurrencia superado	Espera y reintenta. No se cobra.
502	Problema de nuestro lado o del origen	Reintenta. No se cobra.

Límites de tasa

Cada clave admite por defecto 60 llamadas por minuto con concurrencia limitada. Al superarlo recibes 429, no una cola.

¿Necesitas más? Escríbenos.