# Facebook

29 endpoints on Facebook. Every one returns the same response shape and has a flat, published price in credits.

Category: [Social networks](https://onekey.dev/docs/categories/social.md) · [Overview page](https://onekey.dev/platforms/facebook)

> [!NOTE] **26 of 29 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`ad_library`](https://onekey.dev/docs/api/facebook/ad_library.md) | Search the Facebook/Instagram Ad Library (public political/issue and EU ads) by keyword. | 2 credits | beta |
| [`adlibrary_ad`](https://onekey.dev/docs/api/facebook/adlibrary_ad.md) | Get Facebook Ad Library ad details. | 2 credits | beta **needs a pack** |
| [`adlibrary_ad_transcript`](https://onekey.dev/docs/api/facebook/adlibrary_ad_transcript.md) | Get a Facebook Ad Library video ad transcript. | 2 credits | beta **needs a pack** |
| [`adlibrary_company_ads`](https://onekey.dev/docs/api/facebook/adlibrary_company_ads.md) | List Facebook Ad Library company ads. | 3 credits | beta **needs a pack** |
| [`adlibrary_search_companies`](https://onekey.dev/docs/api/facebook/adlibrary_search_companies.md) | Search Facebook Ad Library companies. | 3 credits | beta **needs a pack** |
| [`event_details`](https://onekey.dev/docs/api/facebook/event_details.md) | Get details for a Facebook event. | 2 credits | beta **needs a pack** |
| [`events`](https://onekey.dev/docs/api/facebook/events.md) | List Facebook events for a city. | 2 credits | beta **needs a pack** |
| [`events_search`](https://onekey.dev/docs/api/facebook/events_search.md) | Search Facebook events by keyword. | 2 credits | beta **needs a pack** |
| [`group`](https://onekey.dev/docs/api/facebook/group.md) | Get a Facebook group. | 2 credits | beta **needs a pack** |
| [`group_posts`](https://onekey.dev/docs/api/facebook/group_posts.md) | List Facebook group posts. | 2 credits | beta **needs a pack** |
| [`marketplace_item`](https://onekey.dev/docs/api/facebook/marketplace_item.md) | Get a Facebook Marketplace item. | 2 credits | beta **needs a pack** |
| [`marketplace_location_search`](https://onekey.dev/docs/api/facebook/marketplace_location_search.md) | Search Facebook Marketplace locations. | 2 credits | beta **needs a pack** |
| [`marketplace_search`](https://onekey.dev/docs/api/facebook/marketplace_search.md) | Search Facebook Marketplace listings. | 2 credits | beta **needs a pack** |
| [`page`](https://onekey.dev/docs/api/facebook/page.md) | Facebook page: name, about, category, followers, likes, link, picture. | 2 credits | beta **may need a pack** |
| [`page_events`](https://onekey.dev/docs/api/facebook/page_events.md) | Events of a Facebook page. | 2 credits | beta **may need a pack** |
| [`page_photos`](https://onekey.dev/docs/api/facebook/page_photos.md) | Photos uploaded by a Facebook page. | 2 credits | beta **may need a pack** |
| [`page_posts`](https://onekey.dev/docs/api/facebook/page_posts.md) | Recent public posts of a Facebook page. | 2 credits | beta **may need a pack** |
| [`page_videos`](https://onekey.dev/docs/api/facebook/page_videos.md) | Videos published by a Facebook page. | 2 credits | beta |
| [`post`](https://onekey.dev/docs/api/facebook/post.md) | A single Facebook post with reaction/comment/share counts. | 2 credits | beta **may need a pack** |
| [`post_comment_replies`](https://onekey.dev/docs/api/facebook/post_comment_replies.md) | List replies to a Facebook post comment. | 2 credits | beta **needs a pack** |
| [`post_comments`](https://onekey.dev/docs/api/facebook/post_comments.md) | Comments on a Facebook post. | 2 credits | beta **may need a pack** |
| [`post_transcript`](https://onekey.dev/docs/api/facebook/post_transcript.md) | Get Facebook video transcript. | 2 credits | beta **needs a pack** |
| [`profile_full`](https://onekey.dev/docs/api/facebook/profile_full.md) | Facebook profile, recent posts, and computed analytics in one call. | 2 credits | beta **needs a pack** |
| [`profile_reels_full`](https://onekey.dev/docs/api/facebook/profile_reels_full.md) | Facebook profile reels with exact views, likes, comments, and shares merged in, in one call. | 3 credits | beta **needs a pack** |
| [`search_groups`](https://onekey.dev/docs/api/facebook/search_groups.md) | Search Facebook groups by keyword. | 2 credits | beta **needs a pack** |
| [`search_pages`](https://onekey.dev/docs/api/facebook/search_pages.md) | Search public Facebook pages by name (Pages Search, needs Page Public Metadata Access). | 2 credits | beta |
| [`search_people`](https://onekey.dev/docs/api/facebook/search_people.md) | Search Facebook people by keyword. | 2 credits | beta **needs a pack** |
| [`search_posts`](https://onekey.dev/docs/api/facebook/search_posts.md) | Search Facebook posts by keyword. | 2 credits | beta **needs a pack** |
| [`search_videos`](https://onekey.dev/docs/api/facebook/search_videos.md) | Search Facebook videos by keyword. | 2 credits | beta **needs a pack** |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.