# Facebook Search Mentions API (https://www.socialcrawl.dev/platforms/facebook/search-mentions)

> Returns public Facebook posts by other people and pages that mention a page. Facebook links a mention by the page's name, not an @handle, so the search is the page's name on /v1/facebook/search/posts, newest first (`name`, which defaults to `handle`), and each row is kept only when its text names the page (the whole word, any case), @mentions the handle, or links the page. The page's own posts are left out unless `include_self=true`. Each row in `data.items` is exactly the row the named search endpoint returns, with its `post` and `computed` blocks, plus `match_kind` (`mention` or `link`). `since` and `until` are sent as the search's `start_date` and `end_date`. Send `data.next_cursor` back as `cursor` for the next page; it is null when every search has run out. `data.legs` reports each search: its endpoint, status, rows returned and kept, credits and `request_id`. `data.excluded` counts the rows left out (`unmatched`, `self`, `duplicate`, `outside_window`). Each page is one /v1/facebook/search/posts page, 1 credit.

TL;DR: `GET /v1/facebook/search/mentions` costs Metered, 0-1 credits: each call reads one page of /v1/facebook/search/posts (1 credit), each billed at that endpoint's own price exactly as a direct call is. A page that found nothing or failed costs nothing, and a page served from cache is free. A page is billed when it returned rows, even if none of them carried the mention; data.legs shows each page's charge and data.excluded what was left out. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The page's username (facebook.com/<username>), with or without the @, or its URL. Used to leave out the page's own posts. |
| `cursor` | no | data.next_cursor from the previous response, sent back verbatim for the next page. |
| `since` | no | Only posts published on or after this date, YYYY-MM-DD (UTC). |
| `until` | no | Only posts published on or before this date, YYYY-MM-DD (UTC); that whole day is included. |
| `name` | no | The name people write when they mention the page, for example Nykaa for facebook.com/mynykaa. Defaults to handle. |
| `include_self` | no | When true, also keep posts by the account itself. Default false. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/facebook/search/mentions" \
  --data-urlencode "handle=myntra" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing