Facebook Company Reviews
Facebook Company Reviews are public Page recommendations or ratings with written feedback, reviewer identity, publication time, visible likes, and company-level review signals. These records support feedback research, reputation snapshots, reviewer-context analysis, and comparisons across known Pages.
Features
- Page review URL collectionAccept one or more supported Facebook Page /reviews URLs and collect the public review rows available for each input.
- Review and reviewer recordsReturn review IDs, source URLs, text, reviewer names and profile links, visible likes, rating values, and publication times in a normalized structure.
- Company-level contextKeep company names, Page URLs, aggregate ratings, and total review counts alongside individual reviews for source-level comparison.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Facebook Page review URLs on facebook.com, www.facebook.com, or m.facebook.com whose path contains /reviews, separated by commas or new lines. |
results_limit | Optional | Maximum reviews requested per input URL, from 20 through 2,000; the default is 100 and available public results can be fewer. |
How to Use
Submit Facebook Page /reviews URLs as an asynchronous task, poll its task ID, then read normalized review records with cursor pagination.
- Prepare one or more public Facebook Page URLs whose path contains /reviews.
- POST urls and an optional results_limit to /v1/facebook/company-reviews.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read /v1/tasks/{task_id}?limit=50 and pass results.next_cursor as cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Best Use Cases
- Feedback dataset preparation: Use review text, rating values, publication times, and source URLs to prepare public feedback datasets for downstream topic or sentiment analysis.
- Reputation snapshot reporting: Combine individual review ratings with company-level ratings and total review counts to document the visible state of selected Pages.
- Reviewer engagement research: Use reviewer names, profile links, and visible like counts to examine who contributed public feedback and which reviews drew engagement.
Pro Tips
- Use a resolvable Facebook Page /reviews URL rather than a company name or a general Page URL.
- Set results_limit for each input URL according to the depth you need, and expect fewer rows when Facebook exposes less public review history.
- Submit each Page URL once because duplicate input URLs are removed before collection.
- Treat reviewer links, ratings, likes, timestamps, and company aggregates as nullable when Facebook does not expose a value.
- Follow results.next_cursor until results.has_more is false so large completed tasks are read without skipping stored records.
Related APIs
Use these APIs when you need a different type of public Facebook data.
- Facebook Pages API — Retrieve public Page profiles, contact details, images, and visible audience ratings.
- Facebook Posts API — Collect public posts, media, reactions, comments, and shares from supported Facebook URLs.
- Facebook Comments API — Collect public comments, authors, engagement, media, and source links from post URLs.
- Facebook Video Transcript API — Extract available transcript text and format from known public video post or Reel URLs.
- Facebook Group Posts API — Collect public posts from Facebook group URLs with selectable ordering, per-group limits, author context, video media, and visible engagement.
- Facebook Events Search API — Search public events by keyword with schedule, place, attendance, cover media, and event-state fields.
- Facebook Ad Transcript API — Extract available spoken-word text, language, format, and source context from Facebook Ad Library URLs.
- Facebook Comment Replies API — Retrieve public replies for a known comment using its feedback ID and expansion token, with text, author identity, engagement, and parent context.
- Facebook Event Details API — Collect normalized metadata, schedules, locations, media, and visible engagement from known public event URLs.
- Facebook Profile Events API — Collect public events associated with profile or Page URLs, including names, schedules, locations, media, visible metrics, and source context.
- Facebook Profile Photos API — Collect public photos from profile or Page URLs with captions, author context, engagement, image metadata, and source references.
- Facebook Profiles API — Look up public profiles or Pages from known Facebook URLs with identity, bio, avatar, visible counters, and input context.
- Facebook Reels API — Collect public Reels from profile or Page URLs with captions, author context, video metadata, visible engagement, and source references.