Documentación

Primeros pasos

Del registro a tus primeros datos en directo en pocos minutos. Envías una dirección web o un término de búsqueda junto con tu clave de API y recibes los datos en JSON. Después, un breve repaso de errores, límites y caché.

Tres pasos

1
Crea tu cuenta
Introduce tu correo electrónico, confírmalo con el enlace que te enviamos y elige una contraseña. Regístrate gratis
2
Copia tu clave de API
En tu primera visita, el panel crea una clave llamada “default” y la muestra una sola vez. Cópiala y guárdala en un lugar seguro.
3
Haz tu primera solicitud
Pulsa Probar en la guía rápida del panel o ejecuta la solicitud de abajo con tu clave.

Tu clave de API

Envía tu clave con cada solicitud en la cabecera x-api-key. Las claves empiezan por ds_. Solo guardamos una huella de cada clave, por lo que se muestra completa una única vez, al crearla. Guárdala en un gestor de secretos, nunca en código que se ejecute en un navegador. Puedes crear más claves y revocar las antiguas en Claves de API.

x-api-key: ds_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL base: https://api.everydata.io.

Tu primera solicitud

Busca “wireless headphones” en Amazon. Es la misma solicitud que el botón Probar del panel, donde tu clave ya aparece rellenada justo después de crearla. withCache=true admite una respuesta de hasta 10 minutos de antigüedad, lo que la hace rápida.

GET /amz/amazon-search-by-keyword-asin

curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?domainCode=com&keyword=wireless+headphones&page=1&withCache=true" \
  -H "x-api-key: YOUR_API_KEY"

Qué se devuelve

Toda respuesta correcta es un JSON que empieza con los mismos dos campos, responseStatus y responseMessage, seguidos de los datos de ese endpoint. Las páginas de resultados añaden currentPage, nextPage y lastPage.

200 OK

{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "domainCode": "com",
  "keyword": "wireless headphones",
  "foundProducts": [
    "…"
  ],
  "searchProductDetails": [
    "…"
  ]
}

Errores

Los errores devuelven un pequeño JSON con el estado HTTP y un mensaje legible. Solo las respuestas correctas y los 404 (un “no encontrado” válido) cuentan para tu cuota.

400 Bad Request

{
  "statusCode": 400,
  "statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}

HTTP	Significado	Se cuenta
200	Correcto. Los datos siguen a responseStatus y responseMessage.	Sí
400	Falta un parámetro obligatorio o tiene un formato incorrecto.	No
401	La clave de API falta, es incorrecta o se ha revocado.	No
403	Tu cuota mensual (o el límite de uso razonable) se ha agotado.	No
404	La página se ha cargado, pero no hay ningún producto ni anuncio para tu entrada.	Sí
429	Demasiadas solicitudes por minuto. El mensaje indica cuántos segundos hay que esperar.	No
502	El sitio ha bloqueado este intento. Vuelve a intentarlo.	No
503	No se ha podido cargar el sitio. Vuelve a intentarlo.	No

Límites y cuota

Se aplican dos límites por cuenta: solicitudes por minuto (de 10 a 750, según el plan) y solicitudes al mes. Ambos se comparten entre todas las plataformas y todas las claves de tu cuenta. Demasiadas solicitudes por minuto devuelven 429; cuando se agota la cuota mensual recibes 403 hasta que se restablece al inicio del siguiente periodo de facturación.

Las solicitudes que fallan porque no se ha podido cargar un sitio (5xx) no se cuentan. Tu uso actual está en la página de uso; en precios figuran los límites de cada plan.

Caché

Por defecto, las respuestas son en directo. Cuando la velocidad importa más que la actualidad, varios endpoints aceptan withCache=true o cacheTtl (segundos) y pueden responder desde una copia reciente. Una respuesta en caché también cuenta como una solicitud.

Siguiente: explora la referencia de la API completa.