Skip to content

API Status Codes

200 OK

The request was delivered successfully.

{
    "request_id": "1647621154027256886-2150e105-56d3-40",
    "total": 57182,
    "pages": 5719,
    "profiles": [
        {
            "company_name": "McDonald's",
            "url": "https://foursquare.com/v/mcdonalds/4fbb92b8e4b055f4b2f009f8",
            "domain": "mcdonalds.com",
            "review_source": "foursquare",
            "reported_review_count": 3,
            "reported_rating": 2.75,
            "review_count": 3,
            "review_average": 2.75
        },
    ...
}
201 CREATED

The request was accepted, job has been enqueued for processing.

{
    "success": true,
    "message": "Your task was successfully submitted.",
    "request_id": "1647761879090578224-98f69326-71a4-4e"
}
400 BAD REQUEST

Invalid request. Check your parameters.

{
    "success": false,
    "message": "Bad request",
    "request_id": "1647761809872655750-edfda5ef-c39b-4b",
    "details": "Missing parameter: callback. If you are using the update parameter, you must provide a callback URL. We are not able to fetch your reviews in such a short time, this process is running in the background and might take a couple of minutes. Once the job is finished, we will POST results to provided callback."
}
401 UNAUTHORIZED

Missing or invalid API key.

{
    "success": false,
    "message": "User unauthorized.",
    "request_id": "1647762006517428506-2403ffa-e810-40",
    "details": "Please make sure your API key is valid and then retry the request."
}
429 TOO MANY REQUESTS

Rate limit violation.

    "success": false,
    "message": "Too many requests.",
    "request_id": "1647762006517428506-2403ffa-e810-40",
    "details": "API usage limit has been violated."

500 INTERNAL SERVER ERROR

Application failed.

    "success": false,
    "message": "Sorry, we were not able to process your request. Please try again. If the issue persists, please get in touch with us at support@datashake.com.",
    "request_id": "1647762006517428506-2403ffa-e810-40",
    "details": null

521 NO RESULTS

No search results found.

    "success": false,
    "message": "Sorry, we were not able to find any results for your search. Try to modify the request by adding more information about the company and make sure we support the company requested. If the issue persists, please get in touch with us at support@datashake.com.",
    "request_id": "1647762006517428506-2403ffa-e810-40",
    "details": null