Docs
Getting started
From sign-up to your first live data in a few minutes. You send a web address or a search term together with your API key, and you get the data back as JSON. Then a short look at errors, limits and caching.
Three steps
- 1
Create your account
Enter your e-mail, confirm it with the link we send you and set a password. Sign up for free
- 2
Copy your API key
On your first visit, the dashboard creates a key named “default” and shows it once. Copy it and keep it safe.
- 3
Make your first request
Press Try it in the dashboard quickstart, or run the request below with your key.
Your API key
Send your key with every request in the x-api-key header. Keys start with ds_. We only store a fingerprint of each key, so it is shown in full only once, when it is created. Store it in a secret manager, never in code that runs in a browser. You can create more keys and revoke old ones under API keys.
x-api-key: ds_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBase URL: https://api.everydata.io.
Your first request
Search Amazon for “wireless headphones”. This is the same request as the Try it button in the dashboard, where your key is already filled in right after it is created. withCache=true allows an answer up to 10 minutes old, which makes it fast.
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"What comes back
Every successful answer is JSON that starts with the same two fields, responseStatus and responseMessage, followed by the data of that endpoint. Pages of results add currentPage, nextPage and lastPage.
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"domainCode": "com",
"keyword": "wireless headphones",
"foundProducts": [
"…"
],
"searchProductDetails": [
"…"
]
}Errors
Errors return a small JSON body with the HTTP status and a readable message. Only successful answers and 404 (a valid “not found”) count against your quota.
{
"statusCode": 400,
"statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}| HTTP | Meaning | Counted |
|---|---|---|
| 200 | Success. The data follows responseStatus and responseMessage. | Yes |
| 400 | A required parameter is missing or has the wrong format. | No |
| 401 | The API key is missing, wrong or revoked. | No |
| 403 | Your monthly quota (or the fair-use limit) is used up. | No |
| 404 | The page was loaded, but there is no product or listing for your input. | Yes |
| 429 | Too many requests per minute. The message says how many seconds to wait. | No |
| 502 | The site blocked this attempt. Retry. | No |
| 503 | The site could not be loaded. Retry. | No |
Limits & quota
Two limits apply per account: requests per minute (10 to 750, depending on plan) and requests per month. Both are shared by all platforms and all keys of your account. Too many requests per minute return 429; when the monthly quota is used up you get 403 until it resets at the start of the next billing period.
Requests that fail because a site could not be loaded (5xx) are not counted. Your current usage is on the usage page; pricing lists the limits of each plan.
Caching
Answers are live by default. Where speed matters more than freshness, several endpoints accept withCache=true or cacheTtl (seconds) and may answer from a recent copy. A cached answer still counts as one request.
Next: browse the full API reference.
Google Sheets & Excel (CSV)
Every data endpoint is also available as CSV: put /csv in front of its path. Because a spreadsheet formula cannot send headers, the key may be passed as the apiKey query parameter. In Google Sheets, one formula loads the table into the sheet:
=IMPORTDATA("https://api.everydata.io/csv/ott/otto-search-by-keyword?keyword=kaffeemaschine&fields=productDescription,price,dpUrl&apiKey=YOUR_API_KEY")Each item of the main list (search results, reviews, history points …) becomes a row; a single product becomes one row. Nested fields become columns with a dot in the name (mainImage.imageUrl), lists of values are joined with ; , lists of objects appear as JSON text. responseStatus and responseMessage are not columns.
Options: fields=a,b,c picks the columns and their order, header=false leaves out the heading row, rows=offers chooses another list as rows. All other parameters go to the endpoint unchanged.
Each call – and so each time Google Sheets reloads the formula, typically about once an hour – is a normal request with the same quota, weight and rate limits as the JSON call. Errors keep their HTTP status and return a CSV with one error column, so the cell shows the message. Text that starts with =, +, - or @ gets a leading apostrophe, so the spreadsheet never runs it as a formula.
The key in the URL is visible to everyone who can open the sheet. Use a separate key per sheet and revoke it under API keys if the sheet is shared too widely. In Excel use Data → From Web with the same URL. Step by step: Google Sheets guide.