---
title: "Search Facebook Pages for a mention"
method: GET
path: "/v1/social-accounts/{id}/facebook-pages/search"
tags: ["Social Accounts"]
---

# Search Facebook Pages for a mention

`GET /v1/social-accounts/{id}/facebook-pages/search`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/social-accounts/{id}/facebook-pages/search`
- Auth: `bearerAuth` (a scheme the document does not define)

Resolve an eligible Facebook Page name to the numeric ID needed by platformOptions.facebook.mentionPages. The connected account must be Facebook. If Meta does not permit Page lookup on that connection, the successful response explains that callers need the Page ID instead.

## Path parameters

- `id` string, required

## Query parameters

- `q` string, required

## Response `200`

Matching Pages or a lookup warning

- object
  - `pages` object[], required
    - `id` string, required: Numeric Facebook Page ID.
    - `name` string, required
    - `subtitle` string: Page username, when Meta returns one.
  - `warning` string: Why no lookup result could be returned, with the Page ID fallback.

## Other responses

- `400`: The account is not Facebook or cannot be used for Page lookup
- `401`: Unauthorized
- `404`: Unknown connected account

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)