---
title: "Facebook"
description: "Public pages, their posts, videos and Reels with reactions, comments and shares, keyword search and comments."
url: https://docs.sonderlabs.co.uk/platforms/facebook
---

# 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](https://docs.sonderlabs.co.uk/concepts#the-post)). 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 post:

```json
{
  "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

> **Early access:** The REST API below is in early access: its endpoints are the planned shape and are not open for self-serve use yet. [Request access](https://docs.sonderlabs.co.uk/access). Live today: the [MCP server](https://docs.sonderlabs.co.uk/mcp) and the [free datasets](https://docs.sonderlabs.co.uk/datasets).

Planned shape:

```http
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>
```