Platforms

Facebook

Public pages, their posts, videos and Reels with reactions, comments and shares, keyword search and comments.

What you can get

Data	Status	Notes
Profiles	Live	A page's name and followers.
Posts and stats	Live	Views on videos and Reels only; Facebook does not publish views for other posts.
Keyword search	Live	Public posts that match a word or phrase, in a date window.
Hashtag search	Limited	Hashtags are searched as text.
Sound search	Not available
Comments	Live	The public comments under a post, with likes and replies.
Transcripts	Not available
On-screen text	Limited	Read from the post's cover image only.
Media files	Not available
Audience (estimated)	Limited	Estimated from commenters' names and comment text only; no profile lookups.
Trends	Not available
Footage matching	Not available

Post fields

Every platform returns the same post shape (all fields). On Facebook:

likes is the total of all reactions.
views is null on posts that are not videos.
Search returns the most recent public posts and videos first.

Search kinds: keyword.

Example post

A real public post found by Sonder's Red Bull Rampage 2026 demo campaign (illustration, not a client result). Numbers as of 2026-11-02.

A Facebook postjson

{
  "id": "eb2ff79d7930bbcaa96d7c1b47e6ba8b",
  "platform": "facebook",
  "externalId": "1660418158776022",
  "url": "https://www.facebook.com/reel/3383053288561192/",
  "creator": {
    "handle": "pinkbikecom",
    "name": "Pinkbike",
    "followers": 1110142
  },
  "caption": "Official wind hold at Red Bull Rampage until 12:05 local time",
  "hashtags": [],
  "postedAt": "2026-10-10T17:45:57Z",
  "durationSec": 22,
  "views": 86007,
  "viewsEstimated": false,
  "likes": 704,
  "comments": 17,
  "shares": 0,
  "transcriptExcerpt": null,
  "onscreenText": "Wind hold at Red Bull Rampage finals 2026",
  "asOf": "2026-11-02T23:04:08Z"
}

Planned endpoints

Planned shapehttp

GET /v1/posts/search?platforms=facebook&q=red+bull+rampage&kind=keyword&since=2026-10-01 HTTP/1.1
Host: api.sonderlabs.co.uk
Authorization: Bearer <your API key>