GET
/
reviews
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/reviews?platform=gmb
{
    "facebook": [
        {
            "created": "2023-07-11T21:14:41.000Z",
            "id": "376602035206384",
            "rating": "positive", // Rating positive, negative
            "review": "Makes things easy for connecting social accounts and publishing.",
            "reviewer": {
                "name": "Sue Smith",
                "id": "7283511115003",
                "profile": {
                    "height": 50,
                    "isSilhouette": false,
                    // The URL of the profile picture valid for at least 7 days
                    "url": "https://platform-lookaside.fbsbx.com/platform/profilepic/",
                    "width": 50
                }
            }
        },
        {
            "created": "2023-04-19T02:45:05.000Z",
            "id": "376602035206385",
            "rating": "positive", // Rating positive, negative
            "review": "What an amazing product",
            "reviewer": {
                "name": "John Smith",
                "id": "7501289573254",
                "profile": {
                    "height": 50,
                    "isSilhouette": false,
                    // The URL of the profile picture valid for at least 7 days
                    "url": "https://platform-lookaside.fbsbx.com/platform/profilepic/",
                    "width": 50
                }
            }
        }
    ],
    "lastUpdated": "2024-02-05T22:47:42.996Z",
    "nextUpdate": "2024-02-05T22:58:42.996Z"
},
{
    "gmb": [
        {
            "created": "2023-07-11T21:23:57.707819Z",
            "id": "AbFvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE", // Rating ONE, TWO, THREE, FOUR, FIVE
            "review": "Been a great experience - like the documentation, example coding, and help desk.",
            "reviewReply": {
                "reply": "Thank you for the great thoughts.",
                "updated": "2024-02-05T22:36:17.989625Z"
            },
            "reviewer": {
                "name": "Mads Max",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjV-MlTLJh9CdosuaS_28Dx2aOZi"
            },
            "updated": "2023-07-11T21:23:57.707819Z"
        },
        {
            "created": "2023-05-09T19:27:04.839089Z",
            "id": "FFFvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE", // Rating ONE, TWO, THREE, FOUR, FIVE
            "review": "Great service, really useful product, well-crafted",
            "reviewReply": {},
            "reviewer": {
                "name": "V the Man",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjULaIDBWwT"
            },
            "updated": "2023-05-09T19:27:04.839089Z"
        },
        {
            "created": "2023-05-02T19:04:54.814104Z",
            "id": "BBBOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE",
            "review": "Ayrshare has been a top-notch product and much needed for CRM.  We integrated the API a while back and the code samples in the docs provided by the team have been great.  I've also been happy with the new features they've added like on TikTok and Instagram as well as with their support during the integration process.",
            "reviewReply": {},
            "reviewer": {
                "name": "David Manning",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjXph_y96HMlmDJMJaEHJ1vGkFseinq1UasKOy"
            },
            "updated": "2023-05-02T19:04:54.814104Z"
        },
        {
            "created": "2023-04-16T22:30:14.481018Z",
            "id": "CCCvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE",
            "review": "I've been using Ayrshare's API for my real estate SaaS platform for a while now and it has been great. Appreciated the help on my coding bug and really excited try the TikTok direct publishing with my users.",
            "reviewReply": {
                "reply": "Thank you.",
                "updated": "2023-04-16T22:41:10.885472Z"
            },
            "reviewer": {
                "name": "Jason Gould",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjUnpfGdErOQUC4zz6Bg3HwFHZz4Lly9gMOJA"
            },
            "updated": "2023-04-16T22:30:14.481018Z"
        }
    ],
    "averageRating": 4.12, // Facebook will be 1, 0, or -1 corresponding to positive, neutral, or negative
    "totalReviewCount": 5,
    "lastUpdated": "2024-02-05T23:05:10.091Z",
    "nextUpdate": "2024-02-05T23:16:10.091Z"
}
Available on Premium, Business, Enterprise plans.

Retrieve all the reviews for the specified platform. Currently only Facebook Page rating reviews and Google Business Profile reviews.

Header Parameters

Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Query Parameters

platform
string
required

Values: facebook, gmb

Request Examples

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/reviews?platform=gmb
{
    "facebook": [
        {
            "created": "2023-07-11T21:14:41.000Z",
            "id": "376602035206384",
            "rating": "positive", // Rating positive, negative
            "review": "Makes things easy for connecting social accounts and publishing.",
            "reviewer": {
                "name": "Sue Smith",
                "id": "7283511115003",
                "profile": {
                    "height": 50,
                    "isSilhouette": false,
                    // The URL of the profile picture valid for at least 7 days
                    "url": "https://platform-lookaside.fbsbx.com/platform/profilepic/",
                    "width": 50
                }
            }
        },
        {
            "created": "2023-04-19T02:45:05.000Z",
            "id": "376602035206385",
            "rating": "positive", // Rating positive, negative
            "review": "What an amazing product",
            "reviewer": {
                "name": "John Smith",
                "id": "7501289573254",
                "profile": {
                    "height": 50,
                    "isSilhouette": false,
                    // The URL of the profile picture valid for at least 7 days
                    "url": "https://platform-lookaside.fbsbx.com/platform/profilepic/",
                    "width": 50
                }
            }
        }
    ],
    "lastUpdated": "2024-02-05T22:47:42.996Z",
    "nextUpdate": "2024-02-05T22:58:42.996Z"
},
{
    "gmb": [
        {
            "created": "2023-07-11T21:23:57.707819Z",
            "id": "AbFvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE", // Rating ONE, TWO, THREE, FOUR, FIVE
            "review": "Been a great experience - like the documentation, example coding, and help desk.",
            "reviewReply": {
                "reply": "Thank you for the great thoughts.",
                "updated": "2024-02-05T22:36:17.989625Z"
            },
            "reviewer": {
                "name": "Mads Max",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjV-MlTLJh9CdosuaS_28Dx2aOZi"
            },
            "updated": "2023-07-11T21:23:57.707819Z"
        },
        {
            "created": "2023-05-09T19:27:04.839089Z",
            "id": "FFFvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE", // Rating ONE, TWO, THREE, FOUR, FIVE
            "review": "Great service, really useful product, well-crafted",
            "reviewReply": {},
            "reviewer": {
                "name": "V the Man",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjULaIDBWwT"
            },
            "updated": "2023-05-09T19:27:04.839089Z"
        },
        {
            "created": "2023-05-02T19:04:54.814104Z",
            "id": "BBBOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE",
            "review": "Ayrshare has been a top-notch product and much needed for CRM.  We integrated the API a while back and the code samples in the docs provided by the team have been great.  I've also been happy with the new features they've added like on TikTok and Instagram as well as with their support during the integration process.",
            "reviewReply": {},
            "reviewer": {
                "name": "David Manning",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjXph_y96HMlmDJMJaEHJ1vGkFseinq1UasKOy"
            },
            "updated": "2023-05-02T19:04:54.814104Z"
        },
        {
            "created": "2023-04-16T22:30:14.481018Z",
            "id": "CCCvOqkkVAAQYEe2o5asfICQAGTTG",
            "rating": "FIVE",
            "review": "I've been using Ayrshare's API for my real estate SaaS platform for a while now and it has been great. Appreciated the help on my coding bug and really excited try the TikTok direct publishing with my users.",
            "reviewReply": {
                "reply": "Thank you.",
                "updated": "2023-04-16T22:41:10.885472Z"
            },
            "reviewer": {
                "name": "Jason Gould",
                "profile": "https://lh3.googleusercontent.com/a-/ALV-UjUnpfGdErOQUC4zz6Bg3HwFHZz4Lly9gMOJA"
            },
            "updated": "2023-04-16T22:30:14.481018Z"
        }
    ],
    "averageRating": 4.12, // Facebook will be 1, 0, or -1 corresponding to positive, neutral, or negative
    "totalReviewCount": 5,
    "lastUpdated": "2024-02-05T23:05:10.091Z",
    "nextUpdate": "2024-02-05T23:16:10.091Z"
}