Skip to content

Get reviews

We only collect data that are present on the website. The information collected varies from website to website. If the information is not found, the value is set to None.

It is expected that the number of indexed reviews does not match the total reviews count. Total reviews count reported on the website includes all historical data, whereas our indexer has limitations in fetching historical data. If you are interested in collecting all historical data, please reach out to us.

The more company specifying parameters you provide, the better results you will receive in return.

You can filter results by location using our location parameters.

Base URL

GET https://reviewindexapi.datashake.com/reviews

Request parameters

callback *

string An URL to receive API results.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
name *

string Name of the company you want the reviews for.

Make sure to use official company names (e.g., Chipotle Mexican Grill instead of Chipotle)

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "name": "Five Guys"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
domain

string Domain of the company or product you want the reviews for.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&domain=fiveguys.com&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "name": "Five Guys",
    "domain": "fiveguys.com"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
ticker_symbol

string Company ticker symbol (also known as stock symbol) you want the reviews for.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=McDonalds&ticker_symbol=MCD&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "McDonalds",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "ticker_symbol": "MCD"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
phone_number

string Location phone number you want the reviews for.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&phone_number=%2B1718-797-9380&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "phone_number": "+1718-797-9380"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
street

string Street where the company you want the reviews for is located.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&street=Cedar%20Hills%20Bvld&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "street": "Cedar Hills Bvld"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
city

string City where the company you want the reviews for is located.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&city=Beaverton&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "city": "New York"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
zip_code

string ZIP Code of the company you want the reviews for.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&zip_code=97005&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "zip_code": "97005"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
state

string State where the company you want the reviews for is located.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&state=Oregon&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "state": "Oregon"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
country

string Country where the company you want the reviews for is located.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&country=United%20States&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "country": "United States"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
address

string Full address of the company you want the reviews for.

This will take precedence over the other location parameters.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&address=2606%20Cedar%20Hills%20Blvd%20%2C%20Beaverton%2C%20Oregon%2C%2097005%2C%20United%20States&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "address": "2606 Cedar Hills Blvd , Beaverton, Oregon, 97005, United States"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
review_site

string

Filter reviews from specific review sites. By default, we return reviews from all indexed websites. Narrowing results down will decrease the processing time.

You can request multiple review sites.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&review_site=foursquare&review_site=google&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = [
    ("api_key", "12345"),
    ("name", "Five Guys"),
    ("callback", "https://www.example.com/reviewindexapi_callback"),
    ("review_site", "foursquare"),
    ("review_site", "google")
]
response = requests.get(
    url=url,
    params=params
)            
coming soon
coming soon
coming soon
diff

string Token to get the next page of reviews.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&diff=ac499c9d-99d0-461a-a5d-eef17b9a8c67&page_number=2&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "page_number": 2,
    "diff": "ac499c9d-99d0-461a-a5d-eef17b9a8c67"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
page_number

integer Retrieve a specific page of reviews.

Default value is set to 1 and the maximum value is being returned in the API response.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&diff=ac499c9d-99d0-461a-a5d-eef17b9a8c67&page_number=2&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "page_number": 2,
    "diff": "ac499c9d-99d0-461a-a5d-eef17b9a8c67"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
per_page

integer The number of reviews in one page.

The default value is 50, and the maximum allowed value is 500.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&per_page=100&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "per_page": 100
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
from_date/to_date

string Retrieve reviews within a given time range.

  • from_date parameter indicates the date of the oldest review. The default value is a year ago from the current day.
  • to_date parameter indicates the date of the newest review. The default value is the current date.

Expected format is YYYY-MM-DD.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&from_date=2022-01-01&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "from_date": "2022-01-01"
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
timeseries

boolean Get review volume and average rating per day.

By default, we construct the time series data based on all reviews we have. To narrow down the results, use the time range option.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&timeseries=true&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "timeseries": True
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon
update

boolean If you need more data than we already have (historical or latest), you must request an update.

Without the from_date parameter, we will fetch the latest data only (those we do not have yet). With the from_date parameter, you can also fetch historical reviews we do not yet have.

This process might take more time depending on the number of updated profiles and how old reviews you need.

Code example
curl --request GET --url 'https://reviewindexapi.datashake.com/reviews?name=Five%20Guys&from_date=2022-05-01&update=true&callback=https%3A%2F%2Fwww.example.com%2Freviewindexapi_callback&api_key=12345'
import requests

url = "https://reviewindexapi.datashake.com/reviews"
params = {
    "api_key": "12345",
    "name": "Five Guys",
    "callback": "https://www.example.com/reviewindexapi_callback",
    "from_date": "2022-05-01",
    "update": True
}
response = requests.get(
    url=url,
    params=params
)
coming soon
coming soon
coming soon

Rules and restrictions

  • The name and callback parameters are required.
  • The diff parameter is required for pagination.

Response

  • A summary is based on the data fetched by us, not on the reported values on review profiles
API Response example
{
    "success": true,
    "request": {
          "domain": null,
          "name": "McDonalds",
          "street": null,
          "city": null,
          "zip_code": null,
          "state": null,
          "country": null,
          "address": null,
          "phone_number": null,
          "ticker_symbol": null,
          "callback": "https://eokj2muyinkmabx.m.pipedream.net",
          "review_site": null,
          "from_date": "2021-07-14",
          "to_date": "2022-06-29",
          "page_number": 1,
          "per_page": 5,
          "update": false,
          "timeseries": true,
          "diff": null
    },
    "request_id": "1657806778755440355-c9d9909b-a9fd-4d",
    "timeseries": [
        {
            "date": "2021-07-14",
            "average_rating": 1.49,
            "total_reviews": 201
        },
        {
            "date":"2021-07-15",
            "average_rating": 1.82,
            "total_reviews": 214
        },
        ...
        {
            "date": "2022-06-28",
            "average_rating": 0,
            "total_reviews": 0
        },
        {
            "date": "2022-06-29",
            "average_rating": 1,
            "total_reviews": 1
        }
    ],
    "reviews": [
        {
            "reviewer": "Shannon LaPrad Bowen",
            "date": "2022-06-29T21:33:46",
            "rating": 1,
            "text": "Worst customer service. Employees do not mind handing you a flurry with caramel dripping down the side. No point in complaining to employees (ADZ) who get nasty attitudes. Apparently, if you ask them for a manager’s name they cannot tell you one because they have twenty. That is actually what I was told. Get some more employees and work on customer service. Actually make sure the product is in the cup and not halfway dripping down the side and all over your vehicle",
            "url": "https://www.facebook.com/100000349654323/posts/5337271192961150",
            "profile_picture_url": "https://scontent-ort2-2.xx.fbcdn.net/v/t39.30808-1/279390979_5156068977748040_6754444598531574457_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=106&ccb=1-7&_nc_sid=7206a8&_nc_ohc=VZogDtaSEqMAX_mvatO&_nc_ht=scontent-ort2-2.xx&oh=00_AT_Tt4GxLcNfRfl21eHjOLO88HYt8opB_gmmkyDYZrpzVA&oe=62C99B15",
            "title": null,
            "source": "facebook"
        },
        {
            "reviewer": "Destiny G.",
            "date": "2022-06-13T00:00:00",
            "rating": 1,
            "text": "I came here one time, and I'm not planning to come back. First i didn't get my sauce so after being through the drive thru i had to go inside. I get back in the car to eat my chicken sandwich i payed $7 for, the sandwich was sitting half out of the box, the lettuce was not on the sandwich, there was a little mayo on the corner of the bread, and to add on to all that there was a straw wrapper in the box. There was one person with customer service, the other three were rude. I'm very disappointed.",
            "url": "https://www.yelp.com/biz/mcdonalds-lithia-springs-2?hrid=W5d_GZePnDyJjHnIY2PG7g",
            "profile_picture_url": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "title": null,
            "source": "yelp"
        },
        {
             "reviewer": "Hannah Emma",
             "date": "2022-05-30T11:27:42",
             "rating": 5,
             "text": "Keep up the great work Mrs vanessa,\nFor anyone looking for the best Expert bitcoin trader to invest with should reach out to Mrs vanessa . Her company has proven to be the best trading company. i invested $1000 after 7 days of trading i earn $15000 i'm so grateful to have met Mrs vanessa,\nContact her via now on how you can set up your trading\nWhatsApp;+1 (720) 295-9437\nEmail; vanessaraymond105@gmail.com",
             "url": "https://www.facebook.com/100081044696764/posts/120584740653015",
             "profile_picture_url": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.30808-1/281984425_115354084509414_7855069384391483538_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=106&ccb=1-7&_nc_sid=7206a8&_nc_ohc=RQbYx-d7BOUAX9GYoJe&_nc_ht=scontent-dfw5-2.xx&oh=00_AT8C1RnpK67BzdXEC5cczMtG4FvMe_mf6t5Qe7XGomPZhA&oe=62C9C3A5",
             "title": null,
             "source": "facebook"
        },
        {
            "reviewer": "Jenae Wood Mathes",
            "date": "2022-05-22T17:26:27",
            "rating": 1,
            "text": "Conduct quality checks! Ordered a large fry that wasn’t even filled 1/2 way and the fries were so old!  Two of our cheeseburgers were missing the bottom bun! MANAGEMENT SHOULD BE FIRED!! What a joke of a place!",
            "url": "https://www.facebook.com/692551131/posts/10159798101341132",
            "profile_picture_url": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.30808-1/285124639_10159812488146132_4017120024590575713_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=108&ccb=1-7&_nc_sid=7206a8&_nc_ohc=Lc-Z-kt1ABcAX9tUpV-&_nc_ht=scontent-dfw5-2.xx&oh=00_AT_271TTJiyShibx9PtxeaqcA2d0IWKuQbHiqc4hx-BwBQ&oe=62C9C919",
            "title": null,
            "source": "facebook"
        },
        {
            "reviewer": "Mana Usman",
            "date": "2022-05-07T11:27:49",
            "rating": 5,
            "text": "It will be bad to keep this alone to myself I came across the best forex expert ever MRS VANESSA RAYMNOD who really help me to invest, MRS VANESSA RAYMNOD is very honest and diligent in her work. All I did was invest $500 and within 7 days she made $7000 profit for me.\ncontact Via:\nWhatsApp; +1 (720) 295-9437\nEmail; vanessaraymond105@gmail.com",
            "url": "https://www.facebook.com/100080089365782/posts/122580847088227",
            "profile_picture_url": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.30808-1/277803077_109621778384134_1246980321802701644_n.jpg?stp=c0.10.60.60a_cp0_dst-jpg_p60x60&_nc_cat=110&ccb=1-7&_nc_sid=7206a8&_nc_ohc=7fEdm09RtZwAX-mVRgm&_nc_ht=scontent-dfw5-1.xx&oh=00_AT-K-LhKsMEX5NFi04DKMfSi4jyB0td-CIzs0mIs9tMhWQ&oe=62C8CEAA",
            "title": null,
            "source": "facebook"
        }
    ],
    "summary": {
        "total": 2213551,
        "average_rating": 3.41,
        "per_source": [
            {
                "review_site": "google",
                "average_rating": 3.45,
                "total": 2162252
            },
            {
                "review_site": "yelp",
                "average_rating": 1.65,
                "total": 42801
            },
            {
                "review_site": "facebook",
                "average_rating": 1.86,
                "total": 4776
            },
            {
                "review_site": "tripadvisor",
                "average_rating": 2.29,
                "total": 2786
            },
            {
                "review_site": "trustpilot",
                "average_rating": 2.31,
                "total": 594
            },
            {
                "review_site": "foursquare",
                "average_rating": 3.4,
                "total": 328
            },
            {
                "review_site": "glassdoor",
                "average_rating": 3.57,
                "total": 14
            }
        ]
    },
    "organization": {
        "website": "corporate.mcdonalds.com",
        "ticker_symbol": "MCD",
        "address": "110 North Carpenter Street\nChicago, IL 60607\nUnited States",
        "description": "McDonald's Corporation franchises and operates fast-food restaurants in the global restaurant industry. The Company's restaurants serves a variety of value-priced menu products in countries around the world.",
        "industry": "Gaming, Lodging & Restaurants",
        "country_code": "US",
        "sub_industry": "Restaurants",
        "phone_number": "1-630-623-3000",
        "sector": "Consumer Discretionary",
        "number_of_employees": 205000,
        "founded": "12/21/1964",
        "official_name": "McDonald's Corp"
    },
    "pagination":{
        "diff": "5a7077bb-ba75-49aa-bf39-264c1ff66bfX",
        "page_number": 1,
        "per_page": 5,
        "total_pages": 442711
    }
}