How do I list all ads from a Facebook advertiser?

Send a GET request to /v1/facebook/adlibrary/company/ads with either pageId or companyName. SocialCrawl returns every ad the advertiser has ever run, with creative, status, spend range, and impressions metadata.

What filters can I apply to narrow results?

Filter by country (2-letter code), status (ACTIVE/INACTIVE/ALL), media_type (IMAGE/VIDEO/MEME), language, date range (start_date, end_date), and sort_by (total_impressions or relevancy_monthly_grouped).

How much does listing competitor ads cost?

Each request costs 5 credits on the advanced tier and returns a batch of ads with pagination. Trim responses with trim=true to save on payload size. New accounts get 100 free credits — no credit card required to start.

Can I track a competitor's ad strategy over time?

Yes. Pair start_date and end_date with sort_by=relevancy_monthly_grouped to see how a competitor's ad spend and creative strategy have shifted month by month. Perfect for competitive intelligence dashboards.

Does it work for SMB advertisers or just big brands?

Both. The Facebook Ad Library includes every advertiser that has ever run ads on Meta platforms, from solo founders to Fortune 500 brands. If they've run an ad, you can pull it via pageId or companyName.

100 free credits — no credit card required

Facebook Adlibrary Company Ads API

Name: Facebook Adlibrary Company Ads API
Brand: SocialCrawl
Availability: InStock

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.

Last updated July 2026

Start for free View Documentation

Try the Facebook Adlibrary Company Ads API

See real data before writing a single line

GET/v1/facebook/adlibrary/company/ads

11 optional parameters

pageId

Facebook page ID of the advertiser

companyName

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

country

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

status

Status of the ad. Defaults to ACTIVE.

media_type

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

language

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

sort_by

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

start_date

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

end_date

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

cursor

Cursor to paginate through results

trim

Set to true for a trimmed down version of the response

Searching 44 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

Facebook API

What can you do with the Adlibrary Company Ads API?

The Adlibrary Company Ads endpoint gives you structured Facebook data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/facebook/adlibrary/company/ads"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/facebook/adlibrary/company/ads",
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()

const response = await fetch(
  "https://www.socialcrawl.dev/v1/facebook/adlibrary/company/ads",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

Parameters

Parameter	Required	Description
pageId	No	Facebook page ID of the advertiser
companyName	No	The name of the company. Can either use this or pageId
country	No	This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
status	No	Status of the ad. Defaults to ACTIVE. (ALL \| ACTIVE \| INACTIVE)
media_type	No	Media 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)
language	No	Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
sort_by	No	Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. (total_impressions \| relevancy_monthly_grouped)
start_date	No	Start date to search for. Format: YYYY-MM-DD
end_date	No	End date to search for. Format: YYYY-MM-DD
cursor	No	Cursor to paginate through results
trim	No	Set to true for a trimmed down version of the response

Example Response

What does the Facebook Adlibrary Company Ads API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile/videos",
  "data": {
    "items": [
      {
        "post": {
          "id": "7658005300657638669",
          "url": "https://www.tiktok.com/@charlidamelio/video/7658005300657638669",
          "content": {
            "text": "dc @lara.joanna ",
            "media_urls": "https://v19.tiktokcdn-eu.com/4a08329b68e24d90b840a05c9244ba65/6a498c37/video/tos/alisg/tos-alisg-ve-37c799-sg/ocXRU4saOAVGYeJRAAygAjFIzOGsgRf4peSeXk/?a=1233&bti=MzU8OGYpNHYpNzo5ZjEuLjpkLTptNDQwOg%3D%3D&&bt=1135&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=OTg8NGkzZTQ8PDo1NmQ2O0BpanEzd205cmRlPDMzZzczNEAvNWM0NDFfNi8xMjExNF5eYSNmMGwyMmQ0LzBhLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/owxEmiGPia440JkI3PgALU3bB7aBAlzdBEsKB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=bf18ce44&x-expires=1783202400&x-signature=8AANrRWOCWfS6xtQ9JJiHB77vxo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 16.903
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 3417578,
            "likes": 501973,
            "comments": 2618,
            "shares": 6304,
            "saves": 22989
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-07-02T18:51:58.000Z",
          "ext": {
            "music_id": "7656080164593437471",
            "published_at_epoch": 1783018318
          }
        },
        "computed": {
          "engagement_rate": 0.14949,
          "language": null,
          "content_category": "other",
          "estimated_reach": 4101094
        }
      },
      {
        "post": {
          "id": "7657606229484670221",
          "url": "https://www.tiktok.com/@charlidamelio/video/7657606229484670221",
          "content": {
            "text": "@Alexa Davis ",
            "media_urls": "https://v19.tiktokcdn-eu.com/07ada727f60ed77f8504c4c9aee6f992/6a498c31/video/tos/alisg/tos-alisg-ve-37c799-sg/oAmE41FRfIDnKlQAZjDgfcEsqFENRqYDSBGUSB/?a=1233&bti=MzU8OGYpNHYpNzo5ZjEuLjpkLTptNDQwOg%3D%3D&&bt=857&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=NWU8OTg2aTw6ODlpNDU1PEBpanlrNmw5cmxuPDMzZzczNEBfLTEtMy8tXzYxLzYvYTNfYSNlbGVvMmRrYC9hLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/ooZRDflKEE2SIFSfsAqgFBcFEORUAY4jBDl2Yc~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=0ee7ce0e&x-expires=1783202400&x-signature=DiqCJ1sMgLvKp5k1aK2lKgBm7CU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 10.123
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 7205601,
            "likes": 739100,
            "comments": 1943,
            "shares": 6268,
            "saves": 28516
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-07-01T17:03:22.000Z",
          "ext": {
            "music_id": "7656080164593437471",
            "published_at_epoch": 1782925402
          }
        },
        "computed": {
          "engagement_rate": 0.103713,
          "language": null,
          "content_category": "other",
          "estimated_reach": 8646721
        }
      },
      {
        "post": {
          "id": "7657287641641143565",
          "url": "https://www.tiktok.com/@charlidamelio/video/7657287641641143565",
          "content": {
            "text": null,
            "media_urls": "https://v19.tiktokcdn-eu.com/24d5a0ceaf069ce4435f27d4a1fb7fa5/6a498c2d/video/tos/alisg/tos-alisg-ve-37c799-sg/o4IuEqzEKBC3UgRghYEA5FEDZJDB2RL2JfePpS/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&&bt=939&ft=ERfCkaZWD00Q12Nvr-HxzIxRA7lGF3_45SY&mime_type=video_mp4&rc=O2Q8M2k1Nzo7ODkzPGQ2NkBpM3VrZmo5cm01PDMzZzczNEBiYC0yLjU0XjQxNTMxX2FhYSNjZy5mMmRzYC9hLS1kMS9zcw%3D%3D&vvpl=1&l=20260703224143F66ABC3BD3A97DB0685C&btag=e000b0000",
            "thumbnail_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/oEEehFBRSDqxRYEZJgMgAQpzEf2PJiDEJNI7CB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=7ef5f605&x-expires=1783202400&x-signature=10x4mFTkwGHZf2I3P%2FcRrZr6vTo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",
            "duration_seconds": 6.467
          },
          "author": {
            "username": "charlidamelio",
            "display_name": "charli d’amelio",
            "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=e0b099bd&s=PUBLISH&sc=avatar&shcp=132edbea&shp=d05b14bd&t=223449c4&x-expires=1783202400&x-signature=9SsuimlpGdsdlerisiaqvDVLV3c%3D",
            "verified": true
          },
          "engagement": {
            "views": 5941789,
            "likes": 941067,
            "comments": 3165,
            "shares": 17173,
            "saves": 18760
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": false,
            "deleted": false
          },
          "published_at": "2026-06-30T20:27:04.000Z",
          "ext": {
            "music_id": "7530783142774065975",
            "published_at_epoch": 1782851224
          }
        },
        "computed": {
          "engagement_rate": 0.161804,
          "language": null,
          "content_category": null,
          "estimated_reach": 7130147
        }
      }
    ],
    "next_cursor": "1782516110000",
    "total": 10
  },
  "dropped": 0,
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": "sc.eyJ2IjoyLCJjIjoiMTc4MjUxNjExMDAwMCIsInAiOiJtYXhfY3Vyc29yIn0",
    "has_more": true,
    "page_size": 10
  }
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

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 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.

One schema for every platform — write your integration once
Computed fields on every response: engagement rate, reach, category, language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Real-time data from Facebook — no caching, no delays

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 44 platforms covering 10B+ monthly active users.

One schema, every platform

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

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

See your data before you code

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

import requests

response = requests.get(
    'https://www.socialcrawl.dev/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": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 44 platforms

FAQ

Have a question? We got answers

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

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Ready to scrape Facebook Adlibrary Company Ads data?

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

Start for free