100 free credits — no credit card required.Start building
Logo
100 free credits — no credit card required

Adlibrary Company Ads Data API

Scrape Facebook Adlibrary Company Ads data with one API call. Returns ads from a specific company/page in the Facebook Ad Library. Each ad includes creative, status, spend, and targeting info.

Try the Facebook Adlibrary Company Ads API

See real data before writing a single line

GET/v1/facebook/adlibrary/company/ads
11 optional parameters

Facebook page ID of the advertiser

The name of the company. Can either use this or pageId

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

Status of the ad. Defaults to ACTIVE.

Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.

Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc

Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.

Start date to search for. Format: YYYY-MM-DD

End date to search for. Format: YYYY-MM-DD

Cursor to paginate through results

Set to true for a trimmed down version of the response

Works with 21 platforms

·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·UUtility
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·UUtility
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·UUtility
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·TikTok Shop·Amazon Shop·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·UUtility
Facebook API

What can you do with the Adlibrary Company Ads API?

The Adlibrary Company Ads endpoint gives you structured, AI-enriched Facebook data in a single request. No scraping infrastructure to build or maintain.

Example Request

GET /v1/v1/facebook/adLibrary/company/ads

Parameters

ParameterRequiredDescription
pageIdNoFacebook page ID of the advertiser
companyNameNoThe name of the company. Can either use this or pageId
countryNoThis can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
statusNoStatus of the ad. Defaults to ACTIVE. (ALL | ACTIVE | INACTIVE)
media_typeNoMedia type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme. (ALL | IMAGE | VIDEO | MEME | IMAGE_AND_MEME | NONE)
languageNoLanguage to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
sort_byNoSort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. (total_impressions | relevancy_monthly_grouped)
start_dateNoStart date to search for. Format: YYYY-MM-DD
end_dateNoEnd date to search for. Format: YYYY-MM-DD
cursorNoCursor to paginate through results
trimNoSet to true for a trimmed down version of the response
API Details

How does the Facebook Adlibrary Company Ads API work?

Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with AI-computed fields.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Facebook Adlibrary Company Ads data?

We handle the complexity of Facebook data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 21 platforms covering 10B+ monthly active users.

One schema, every platform

Query 21 platforms with identical response structures. Write your integration once.

AI-enriched, not just scraped

Computed fields on every response: engagement_rate, estimated_reach, content_category, language.

No code required

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://api.socialcrawl.com/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": { "username": "charlidamelio", "followers": 124000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "food" }
  }
}
and many more
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us

Ask AI about SocialCrawl

Ready to scrape Facebook Adlibrary Company Ads data?

Get your API key and start pulling Facebook data in under 60 seconds.

Start for free