Step 1: Create a new job.
Size limit
We limit the number of items that can be requested in a single job to 1,000. If you want to request more than 1,000 products, you can run multiple jobs in parallel.
JSON response
The only relevant information in the JSON response is the job_id. Save this value for steps 2 and 3.
Errors
An error is indicated by an HTTP status code in the 4xx and 5xx ranges. If the error happens on an application level, we try to provide an explanation in JSON.
Non-JSON responses
If something goes wrong somewhere deeper in our stack (say on a load balancer), we might return a different kind of response (like HTML or text).
Example error response
{
"success": false,
"reason": "unauthorized",
"parameter": "token",
"comment": "Provide your API key with the parameter 'token'!"
}<html><body><h1>503 Service Unavailable</h1>
No server is available to handle this request.
</body></html>List of error codes
Error code | Meaning |
|---|---|
| No |
| Not all required parameters were given. |
| Given value is not allowed for this parameter. |
| Chosen |
| Chosen |
| Chosen |
| Combination of |
| Chosen |
| Chosen |
| Not enough free credits left for the given request, a paid subscription is needed. |
| User-defined daily quota is exceeded. You can change this. See Daily quota. |
| Requested more than 1,000 |
| Based on your plan, you are not allowed to use the requested |
| Based on your plan, you are not allowed to use the requested |
Further error codes may be added.