20 % off all paid plans with code

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. 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. 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. 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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Base 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.

200 OK
{
  "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.

400 Bad Request
{
  "statusCode": 400,
  "statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}
HTTPMeaningCounted
200Success. The data follows responseStatus and responseMessage.Yes
400A required parameter is missing or has the wrong format.No
401The API key is missing, wrong or revoked.No
403Your monthly quota (or the fair-use limit) is used up.No
404The page was loaded, but there is no product or listing for your input.Yes
429Too many requests per minute. The message says how many seconds to wait.No
502The site blocked this attempt. Retry.No
503The 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:

Google Sheets
=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.