# Facebook APIs

24 endpoints on Facebook, all called with `POST https://api.primaryapi.com/v1/run/{sku}` and one API key.

| SKU | Name | Price | Summary |
|---|---|---|---|
| [`facebook.ad_details_full`](https://primaryapi.com/docs/api-reference/facebook/ad_details_full) | Facebook Ad Creative Details | 2 credits per call | One Meta Ad Library ad with its full creative: every carousel card or version, image and video URL, headline, body and CTA. |
| [`facebook.ad_details`](https://primaryapi.com/docs/api-reference/facebook/ad_details) | Facebook Ad Details | 2 credits per call | One Meta Ad Library ad by id or URL: advertiser, creative text, call to action, platforms, run dates and media. |
| [`facebook.search_companies`](https://primaryapi.com/docs/api-reference/facebook/search_companies) | Facebook Ad Library Advertiser Search | 2 credits per call | Find Meta Ad Library advertisers by name and get their page ids, category, verification and linked Instagram account. |
| [`facebook.ads_search`](https://primaryapi.com/docs/api-reference/facebook/ads_search) | Facebook Ad Library Search | 1 credit per call | Search the Meta Ad Library by keyword with country, status, media, date and sort filters; returns matching ads with cursor pagination. |
| [`facebook.company_ads`](https://primaryapi.com/docs/api-reference/facebook/company_ads) | Facebook Company Ads | 2 credits per call | The ads one advertiser runs in the Meta Ad Library, by Ad Library page id or company name, with filters and cursor pagination. |
| [`facebook.event_details`](https://primaryapi.com/docs/api-reference/facebook/event_details) | Facebook Event Details | 2 credits per call | Full details of one public Facebook event by id or URL: schedule, venue with coordinates, hosts, description and attendance. |
| [`facebook.events`](https://primaryapi.com/docs/api-reference/facebook/events) | Facebook Events by City | 2 credits per call | Public Facebook events for a city or place from its events-explore URL: name, date, venue and going / interested counts. |
| [`facebook.events_search`](https://primaryapi.com/docs/api-reference/facebook/events_search) | Facebook Events Search | 2 credits per call | Keyword search over public Facebook events returning name, schedule, venue, price range and attendance counts. |
| [`facebook.group_posts`](https://primaryapi.com/docs/api-reference/facebook/group_posts) | Facebook Group Posts | 2 credits per call | Recent posts of a public Facebook group by URL, with sort order and cursor pagination: text, author, reaction and comment counts. |
| [`facebook.marketplace_item`](https://primaryapi.com/docs/api-reference/facebook/marketplace_item) | Facebook Marketplace Item | 2 credits per call | Full details of one Facebook Marketplace listing by id or URL: title, description, price, location, photos, condition and status. |
| [`facebook.marketplace`](https://primaryapi.com/docs/api-reference/facebook/marketplace) | Facebook Marketplace Search | 2 credits per call | Search Facebook Marketplace listings by keyword near a latitude/longitude with price, condition, delivery, recency and availability filters. |
| [`facebook.page_contact`](https://primaryapi.com/docs/api-reference/facebook/page_contact) | Facebook Page Contact Info | 2 credits per call | Public contact details of a Facebook page (email, phone, website, address, price range, rating) by URL, handle or page id. |
| [`facebook.profile_events`](https://primaryapi.com/docs/api-reference/facebook/profile_events) | Facebook Page Events | 2 credits per call | Events hosted by a public Facebook page by URL: name, start time, venue, city, host and status, with cursor pagination. |
| [`facebook.page_lookup`](https://primaryapi.com/docs/api-reference/facebook/page_lookup) | Facebook Page Lookup by Name | 2 credits per call | Resolve a brand or page name to up to 7 matching Facebook pages with id, URL, picture and verified flag. |
| [`facebook.photos`](https://primaryapi.com/docs/api-reference/facebook/photos) | Facebook Page Photos | 2 credits per call | Recent photos of a public Facebook page by URL: image URL, thumbnail, size, caption and photo id, with cursor pagination. |
| [`facebook.profile_posts`](https://primaryapi.com/docs/api-reference/facebook/profile_posts) | Facebook Page Posts | 2 credits per call | Recent public posts of a Facebook page by URL or page id, with cursor pagination: text, time, reactions, comments and media. |
| [`facebook.profile`](https://primaryapi.com/docs/api-reference/facebook/profile) | Facebook Page Profile | 2 credits per call | Public profile of a Facebook page by URL or handle: name, category, intro, followers, likes, website and Ad Library page id. |
| [`facebook.profile_reels`](https://primaryapi.com/docs/api-reference/facebook/profile_reels) | Facebook Page Reels | 2 credits per call | Reels of a public Facebook page by URL with cursor pagination: caption, view count, thumbnail, video URL and permalink. |
| [`facebook.search_pages`](https://primaryapi.com/docs/api-reference/facebook/search_pages) | Facebook Page Search | 6.25 credits per result | Search Facebook pages by keyword, optionally near a place, and get page profiles with category, followers and contact fields. |
| [`facebook.post`](https://primaryapi.com/docs/api-reference/facebook/post) | Facebook Post | 2 credits per call | One public Facebook post or reel by URL: text, author, likes, comments, shares, views, video URL and duration. |
| [`facebook.post_comments`](https://primaryapi.com/docs/api-reference/facebook/post_comments) | Facebook Post Comments | 2 credits per call | Top-level comments of a public Facebook post or reel with cursor pagination: text, author, reactions and reply count. |
| [`facebook.search_posts`](https://primaryapi.com/docs/api-reference/facebook/search_posts) | Facebook Post Search | 3.24 credits per result | Keyword search over public Facebook posts, optionally by date range and place, with post text, author and engagement counts. |
| [`facebook.post_transcript`](https://primaryapi.com/docs/api-reference/facebook/post_transcript) | Facebook Post Transcript | 2 credits per call | Spoken-word transcript of a public Facebook video post or reel by URL (native captions first, AI for clips up to 2 minutes). |
| [`facebook.followers`](https://primaryapi.com/docs/api-reference/facebook/followers) | Facebook Followers / Following List | planned | List the public followers of a Facebook page or profile, or the accounts it follows, as id, name, URL and picture. |
