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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxURL 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.
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.
{
"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.
{
"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.
Google Sheets y Excel (CSV)
Cada endpoint de datos también está disponible como CSV: pon /csv delante de su ruta. Como una fórmula de hoja de cálculo no puede enviar cabeceras, la clave puede ir en el parámetro de consulta apiKey. En Google Sheets, una sola fórmula carga la tabla en la hoja:
=IMPORTDATA("https://api.everydata.io/csv/ott/otto-search-by-keyword?keyword=kaffeemaschine&fields=productDescription,price,dpUrl&apiKey=YOUR_API_KEY")Cada elemento de la lista principal (resultados de búsqueda, reseñas, puntos del historial …) se convierte en una fila; un solo producto es una fila. Los campos anidados se convierten en columnas con un punto en el nombre (mainImage.imageUrl), las listas de valores se unen con ; y las listas de objetos aparecen como texto JSON. responseStatus y responseMessage no son columnas.
Opciones: fields=a,b,c elige las columnas y su orden, header=false omite la fila de encabezado, rows=offers usa otra lista como filas. Todos los demás parámetros llegan al endpoint sin cambios.
Cada llamada – y por tanto cada vez que Google Sheets recarga la fórmula, normalmente una vez por hora – es una solicitud normal con la misma cuota, peso y límite de velocidad que la llamada JSON. Los errores conservan su estado HTTP y devuelven un CSV con una columna error, así la celda muestra el mensaje. Un texto que empieza por =, +, - o @ recibe un apóstrofo delante, para que la hoja nunca lo ejecute como fórmula.
La clave en la URL es visible para cualquiera que pueda abrir la hoja. Usa una clave distinta para cada hoja y revócala en Claves de API si la hoja se ha compartido demasiado. En Excel usa Datos → De la web con la misma URL. Paso a paso: guía de Google Sheets.