Facebook reviews API documentation

We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:

  • The Facebook API returns 5 reviews per request.
  • The order in which reviews are returned is by date from newest to oldest
  • You can get all reviews from a single place by using the cursor parameter. Unlike other integrations, the facebook api doesn't support the offset parameter to paginate the results. Instead the pages need to be iterated one by one. To do this, each response comes with a next_page_cursor field. You can use the value is field to pass it as the cursor parameter in a new request to get the next page in the results.
  • Facebook doesn't use a star based rating anymore. Places are either recommended or not. You can find this in the response as the recommends_rating field. The value of this field will be either null, recommends or doesnt_recommend

To get reviews from Wextractor you will need to perform GET requests against the https://wextractor.com/api/v1/reviews/facebook endpoint.

Reviews endpoint parameters:

Parameter Required Description Example
auth_token Required Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. -
id Required A textual identifier that uniquely identifies a place in Facebook. This identifier is a part of the path that appears in the url for the place in Facebook. For example, if the url for the place in Facebook is https://www.facebook.com/metmuseum/ the identifier is: metmuseum metmuseum
cursor Optional This parameter defines the cursor to use for pagination. After getting the first page of results without sending the cursor parameter. The response will include a next_page_cursor field. To get the following page of results you need to create a new request adding the value of that field as the cursor parameter. -

Example usage:

https://wextractor.com/api/v1/reviews/facebook?auth_token=XXXX&id=metmuseum

Example response:


      {
        "reviews": [
            {
                "text": "I never taught Dr Oje Abacha who could ever get my HIV-AIDS cured with his herbal product.despite all these happening to me.I always spend a lot to buy a HIV drugs from hospital and taking some several medications but no relieve until one day i was just browsing on the internet when i came across a great post of ! Williams Franca who truly said that she was been diagnose with HIV and was healed that very week through the help of these great powerful healing spell doctor. sometime i really wonder why people called him Dr Oje Abacha ,i never knew it was all because of the great and perfect work that he has been doing that is causing all this. so i quickly contacted him and he ask me some few questions and he said a thing i will never forget that anyone who contacted him is always getting his or her healing in just 6 hours after doing all he ask you so i was amazed all the time i heard that from him ,so i did all things only to see that at the very day which he said i will be healed all the strength that has left me before rush back and i became very strong and healthy this disease almost kills my life if not because of Dr Oje Abacha who helped me. so i rush to hospital for the final test. So the doctor said i am HIV negative i am very amazed and happy about the healing Dr Oje Abacha gave to me from the ancient part of Africa ,with a strong herbal concoction. if you are infected with any disease like HIV, AIDS, CANCER,HERPES SIMPLEX VIRUS, or any other disease you can also be happy like me by contacting..... Name: Dr Oje Abacha What apps Number:  +2348114715925 Email: [email protected]   I“m given you 100% grantee, soon as you have getting in touch with Dr Oje Abacha your problems will be solved accurately. Thanks..",
                "comments": 0,
                "reviewer": "Find Boy",
                "id": "metmuseum-1654395825",
                "datetime": "2022-06-05T02:23:45",
                "rating": null,
                "avatar": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/285322929_129873076374133_3913327549475043651_n.jpg?stp=c0.2.60.60a_cp0_dst-jpg_p60x60&_nc_cat=104&ccb=1-7&_nc_sid=7206a8&_nc_ohc=FMZevWb7Se0AX-B02HC&_nc_ht=scontent-atl3-2.xx&oh=00_AT_Ngb2LFqOFQ5wZ29i8KuAlH9zllmzyS3cOj_zDGDhQwQ&oe=62A1F321",
                "url": "https://www.facebook.com/permalink.php?story_fbid=130928016268639&id=100080543244063",
                "story_id": "130928016268639",
                "recommends_rating": "recommends",
                "images": []
            },
            {
                "text": "I was diagnosed with Genital Herpes for the past 2 years and I have been searching for a cure. I have several outbreaks on my back and it really affected me morally, I read a testimony on this platform of a lady from USA who was cured from Diabetes with doctor Osebor Herbal medicine including the doctor's official email address. I contacted Dr Osebor through his email, after much discussion and a few questions he prepared the Herbal medicine and asked for my address. I received the Herbal medicine 3 days later and with his prescription I drank the Herbal medicine for 21 days. After concluding the herbal medicine I went for a test and my IgG result was confirmed Negative with no trace of the virus on my blood. Contact Dr Osebor and be cured by his email;\[email protected] or Whatsapp number +2348073245515\n\nAlso reach him on his Facebook page;\n\nhttps://www.facebook.com/Dr-Osebor-soluting-home-107536841633477",
                "comments": 0,
                "reviewer": "Lee Wilson",
                "id": "metmuseum-1654394819",
                "datetime": "2022-06-05T02:06:59",
                "rating": null,
                "avatar": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/274752194_1201444953724994_2003972523272355689_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=104&ccb=1-7&_nc_sid=7206a8&_nc_ohc=KNhHmz6G2QMAX8Z4THy&_nc_ht=scontent-atl3-2.xx&oh=00_AT_VXedqsLj3Z11NwnSkXIBcUI8NdK1OX7f6uZ87-BlBtA&oe=62A176A0",
                "url": "https://www.facebook.com/imran.msi.75/posts/1263771854158970",
                "story_id": "1263771854158970",
                "recommends_rating": "recommends",
                "images": []
            },
            {
                "text": "Dr Ejes spiritual temple is the right place to contact for solutions to that your challenges you have been facing or battling with,why not let's help you solve it ones and for all so you too can testify like every other person's we have help resolve their spiritual and phisical problems?\njust contact this great spiritualist called Dr Ejes on [email protected] or chat him up directly on WhatsApp +2347082710097.\nWe are specialized in casting love spells, restoring broken marriages and relationships cancer healing powers HIV healing spell's and total recovery,do what i say powerful rings to win political elections cases in court defeating opponents and rivals,and getting any sugar mummy/daddy of your choice crawling at your feet???\nAnd charms to make your clients pay easily and quick with no stress!\nwe are 💯 percent guaranteed?\nWITH GOD ALL THING'S ARE POSSIBLE!!!",
                "comments": 0,
                "reviewer": "Ehiremen Desmond",
                "id": "metmuseum-1654360817",
                "datetime": "2022-06-04T16:40:17",
                "rating": null,
                "avatar": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/285626262_154568507103933_8665740877288707658_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=107&ccb=1-7&_nc_sid=7206a8&_nc_ohc=3uwstgvIzYgAX_CQDFC&_nc_ht=scontent-atl3-2.xx&oh=00_AT-la9Zf7S--dYuEAG-Bqpy6HG-cz-Prc3nAHjVRYgH4mg&oe=62A20F13",
                "url": "https://www.facebook.com/permalink.php?story_fbid=155388163688634&id=100076523541739",
                "story_id": "155388163688634",
                "recommends_rating": "recommends",
                "images": []
            },
            {
                "text": "every time you come to The Met, you will find new things, feeling is different.",
                "comments": 0,
                "reviewer": "Ardell Zhang",
                "id": "metmuseum-1654338791",
                "datetime": "2022-06-04T10:33:11",
                "rating": null,
                "avatar": "https://scontent-atl3-2.xx.fbcdn.net/v/t1.6435-1/117654964_116578756823165_8240896950350530510_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=107&ccb=1-7&_nc_sid=7206a8&_nc_ohc=OX4XX73ghMMAX9ocJmS&_nc_ht=scontent-atl3-2.xx&oh=00_AT-hkTC5sqtOnL5PgETkaS8Z_wFViHkQDmP5AeT1LCyKUw&oe=62C1E74F",
                "url": "https://www.facebook.com/ardell.zhang.144/posts/492058105941893",
                "story_id": "492058105941893",
                "recommends_rating": "recommends",
                "images": []
            },
            {
                "text": "Awesome, I’ll come back..",
                "comments": 0,
                "reviewer": "Fanny del Pino",
                "id": "metmuseum-1654291270",
                "datetime": "2022-06-03T21:21:10",
                "rating": null,
                "avatar": "https://scontent-atl3-2.xx.fbcdn.net/v/t1.6435-1/175961495_4202940586385101_112616459137256411_n.jpg?stp=cp0_dst-jpg_p60x60&_nc_cat=104&ccb=1-7&_nc_sid=7206a8&_nc_ohc=_mm9X3b89oQAX-yL8O7&_nc_ht=scontent-atl3-2.xx&oh=00_AT_yqmNIFIipxZsTcEfHsqKxHwuwcDEgWrGYaTNIuC_iaA&oe=62C44803",
                "url": "https://www.facebook.com/fannynick/posts/5483745018304645",
                "story_id": "5483745018304645",
                "recommends_rating": "recommends",
                "images": []
            }
        ],
        "next_page_cursor": "AQHRzFhIH4g2v_148p7LZGdsN1ZD-yDCPWR54JCk_qHhwTUGYswjG5pS3358H2o0a5qvBcxQZ-L8Q3ntDcjkPmS05w",
        "totals": {
            "review_count": 139680,
            "average_rating": "4.9"
        }
    }

Example of getting all reviews in python:

            import requests
            import json

            auth_token = 'your token'
            place_id = 'metmuseum'

            url = 'https://wextractor.com/api/v1/reviews/facebook?auth_token=' + auth_token + '&id=' + place_id

            all_reviews = []
            reviews = json.loads(requests.get(url).text)
            all_reviews += reviews['reviews']

            while reviews['next_page_cursor']:
                page_url = url + '&cursor=' + reviews['next_page_cursor']
                reviews = json.loads(requests.get(page_url).text)
                all_reviews += reviews['reviews']
                print(reviews)