Company Ads

GET /v1/facebook/adLibrary/company/ads

Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination.

Authentication

All requests require the x-api-key header. Get your key at scrapecreators.com.

Query Parameters

Name	Type	Required	Description	Example
pageId	string	no	The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName	367152833370567
companyName	string	no	The name of the company. Can either use this or pageId	Lululemon
country	string	no	This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.	ALL
status	enum(ALL, ACTIVE, INACTIVE)	no	Status of the ad. Defaults to ACTIVE.	ACTIVE
media_type	enum(ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE)	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
language	string	no	Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc	EN
sort_by	enum(total_impressions, relevancy_monthly_grouped)	no	Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.	total_impressions
start_date	string	no	Start date to search for. Format: YYYY-MM-DD	2025-01-01
end_date	string	no	End date to search for. Format: YYYY-MM-DD	2025-12-31
cursor	string	no	Cursor to paginate through results	AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP
trim	boolean	no	Set to true for a trimmed down version of the response	false

Example Request

curl

curl 'https://api.scrapecreators.com/v1/facebook/adLibrary/company/ads' \
  -H 'x-api-key: $SCRAPECREATORS_API_KEY'

Node / TypeScript

const params = new URLSearchParams({  });
const res = await fetch(`https://api.scrapecreators.com/v1/facebook/adLibrary/company/ads?${params}`, {
  headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);

Python

import os, requests
r = requests.get(
    'https://api.scrapecreators.com/v1/facebook/adLibrary/company/ads',
    headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
    params={},
)
r.raise_for_status()
print(r.json())

CLI

scrapecreators facebook-ads adLibrary-company-ads --help

Example Response

{
  "results": [
    {
      "ad_archive_id": "1212560900568826",
      "end_date": 1750230000,
      "is_aaa_eligible": false,
      "is_active": true,
      "page_id": "15087023444",
      "page_name": "Nike",
      "political_countries": [],
      "reach_estimate": null,
      "snapshot": {
        "body": {
          "text": "Que el frío no te detenga. Explora la colección de invierno con estilo y actitud Nike. 🧥"
        },
        "branded_content": null,
        "brazil_tax_id": null,
        "byline": null,
        "caption": "fb.com",
        "cards": [],
        "cta_text": "Learn more",
        "cta_type": "LEARN_MORE",
        "country_iso_code": null,
        "current_page_name": "Nike",
        "disclaimer_label": null,
        "display_format": "VIDEO",
        "event": null,
        "images": [],
        "is_reshared": false,
        "link_description": null,
        "link_url": "https://fb.com/canvas_doc/569658969305127",
        "page_categories": [
          "Ropa deportiva"
        ],
        "page_entity_type": "PERSON_PROFILE",
        "page_id": "15087023444",
        "page_is_deleted": false,
        "page_is_profile_page": false,
        "page_like_count": 37497718,
        "page_name": "Nike",
        "page_profile_picture_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508742493_1906025190144374_200543536673957484_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=GUPolKbhQA4Q7kNvwH8Woql&_nc_oc=AdnsaYY9-9p8kkFm594f86VsMEc2Wias8yMQ69ZC2VOv642bjUgMRJNtfihFM4vr62o&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfO73iYbuEFgc4yfmi6pUnjLAd0I1W5ac9hmHZqjq2KP3g&oe=685A4C47",
        "page_profile_uri": "https://facebook.com/nike",
        "root_reshared_post": null,
        "title": "Look de invierno activado",
        "videos": [
          {
            "video_hd_url": "https://video-ord5-2.xx.fbcdn.net/v/t42.1790-2/508345466_4710910465802253_4502560017294477681_n.?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_z9ndrNSqU4Q7kNvwErNTOY&_nc_oc=AdlSb3GVLWTjl3iI6uvIsrEya2ZR-1ex8t8yXOr3e9u13u3xboXylCxrkWzfLsvDQcU&_nc_zt=28&_nc_ht=video-ord5-2.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfNNOrS6GBT-R_RV15FpphRv-mUwyGoqJClQpP-LCOcqfQ&oe=685A6586",
            "video_preview_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/508472131_2706791729511119_7655112167724018421_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=-GGzon31Wl4Q7kNvwHpWdG2&_nc_oc=AdnRHcWzvX05mBu9KrhDjKgOuCYLKjNg_hm8eKY2dNaFg-4tpYznNPJvbLl7CAnB-2A&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfMijP4k74e949uFas1PkfzzwiYWH_G49J4W-EYJa31VEQ&oe=685A3DDC",
            "video_sd_url": "https://video-ord5-3.xx.fbcdn.net/v/t42.1790-2/503830433_1272051757688626_4613408767025280545_n.mp4?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zKD6ziOmKVgQ7kNvwFGCx5N&_nc_oc=AdkdTw235NDuAczGAvCTLl5TnQ8rUcWjy1QBEj8CC4Id8hVQPMexxPtU3froQOYk1OE&_nc_zt=28&_nc_ht=video-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxej
... (truncated)

Credits

Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.

Errors

Status	Meaning	Action
200	Success.	Use the JSON payload.
400	Invalid or missing parameter.	Verify required parameters and value format.
401	Missing or invalid x-api-key.	Pass a valid API key in the header.
402	Out of credits.	Top up at scrapecreators.com or wait for plan reset.
404	Resource not found or private.	Confirm the handle, URL, or id and that the resource is public.
429	Rate limited.	Backoff and retry with exponential delay.
500	Server error or upstream platform failure.	Retry with backoff; report persistent errors to support.