Collect Facebook Pages, content, conversations and ads through one API.
Look up a known Facebook Page, collect its posts, reels or comments, or use dedicated advertiser search, company ads, keyword ad search and ad-detail operations. Jobs and batches keep results and credit settlement visible.
A Page handle and an advertiser Page ID are not interchangeable.
Use Page lookup for a known Facebook Page. Start in Advertiser search when the goal is Meta Ad Library research, then pass the selected Page ID to Company ads.
Known Page lookup
Use an exact Page URL or handle to retrieve one Page record and selected Page content.
Posts and conversations
Collect posts, reels, comments and comment replies as separate record sets.
Correct advertiser workflow
Search advertiser names, select a Page ID, collect company ads and retrieve known creatives by ad ID.
Transcripts and analytics
Use dedicated operations for supported video or ad transcripts and Page analytics.
Page identity and account context stay together.
Use an exact Page URL when possible, then use the returned identity for later content research.
{
"platform": "facebook",
"platform_user_id": "140858439260130",
"username": "CadburyUK",
"display_name": "Cadbury",
"follower_count": 10800000,
"verified": true,
"profile_url": "https://www.facebook.com/CadburyUK/"
}Avoid ambiguous brand-handle guesses in Ad Library work.
Advertiser search returns candidate Pages with IDs. After you confirm the intended company, that Page ID becomes the stable target for Company ads.
- 01Choose the Facebook workflowSelect Page, content, conversation, advertiser, ad or transcript collection.
- 02Provide the exact targetUse a Page URL, content URL, advertiser name, Page ID, keyword or ad ID as documented.
- 03Retrieve delivered recordsMonitor the job, review the result and export it when ready.
Keep Page activity and advertising workflows explicit.
Facebook API questions.
How do I collect ads for one company?
Search the advertiser by company name, confirm the candidate Page, then use its Page ID with Company ads. Use Ad by ID when you already know one creative identifier.
Why can a bare handle return the wrong person?
Facebook vanity names can be ambiguous. Use an exact Page URL for Page lookup and the dedicated Advertiser search for Meta Ad Library work.
How is Facebook data billed?
A Page or single content record generally costs one credit, list records cost two, advertiser and ad records cost three, profile analytics costs five, and a delivered transcript costs twenty credits.
Are requested list counts guaranteed?
No. A list limit is a maximum, not a guaranteed result count. Collection stops when the maximum is reached or Facebook has no more visible records, and only delivered data is charged.