Facebook Ad Library Company Search
Facebook Ad Library company candidates are advertiser Pages identified by Page IDs, names, categories, countries, images, verification values, and linked Instagram context. These identity and audience signals support advertiser resolution, same-name Page comparison, and reviewable Page selection before ad research.
Features
- Company and Page-name searchSubmit one non-empty company, brand, or Page-name query and receive every advertiser Page candidate returned for that lookup.
- Page identity and classificationReturn Page IDs, names, derived public URLs, categories, countries, entity types, verification values, images, and deleted-Page state when exposed.
- Visible Page and Instagram signalsKeep available Facebook likes together with linked Instagram usernames, follower counts, and verification state in normalized candidate records.
Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Required non-empty company, brand, or public Page name used to find advertiser Page candidates. |
How to Use
Submit one company or Page-name query, track the asynchronous task, and review the normalized advertiser Page candidates.
- Prepare one non-empty company, brand, or public Page-name query.
- POST query to /v1/facebook-ad-library/company-search and store the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items and request next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Example Sports"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Advertiser Page ID resolution: Use candidate Page IDs, names, URLs, categories, and countries to select the identifier required for a Page-scoped Company Ads request.
- Same-name and regional Page comparison: Compare categories, countries, entity types, images, verification values, and linked Instagram context across similar advertiser names.
- Reviewable advertiser selectors: Store Page identity, visible audience signals, original query, and collection time behind an advertiser picker or research index.
Pro Tips
- Send only query; results_limit and ad status, country, media, or date filters are not accepted by Company Search.
- When several candidates share a familiar name, compare the Page ID, URL, category, country, image, verification, and linked Instagram identity instead of selecting the first result.
- Follow next_cursor until has_more is false so task-result pagination does not hide a stored company candidate.
- Treat Instagram identity, follower counts, verification values, images, and deleted-Page state as optional signals and handle absent fields without rejecting the candidate.
Related APIs
Use these APIs when you need a different type of public Facebook Ad Library data.
- Facebook Ad Library Search API — Search public ads by keyword with match, ad, country, status, media, sort, date, and result-limit controls.
- Facebook Ad Library Company Ads API — Collect public ads for one advertiser Page ID with creative, delivery, market, media, CTA, and visible signal fields.
- Facebook Ad Library Ad API — Collect one public Ad Library ad from its URL with creative, advertiser, media, delivery, CTA, and visible signal fields.