Facebook Ad Library Company Ads API

Get a company's running ads. Use GET normally; for long pagination cursors, use POST with the same parameters in the JSON body.

1 creditper request
GET
/v1/facebook/adLibrary/company/ads
View Code on GitHub
curl "https://api.scrapecreators.com/v1/facebook/adLibrary/company/ads" \
  -H "x-api-key: "
{
  "success": true,
  "credits_remaining": 1000000,
  "credits_charged": 1,
  "results": [
    {
      "ad_archive_id": "1162496978867592",
      "ad_id": null,
      "archive_types": [],
      "categories": [
        "UNKNOWN"
      ],
      "collation_count": 3,
      "collation_id": "596215693307098",
      "contains_digital_created_media": false,
      "contains_sensitive_content": false,
      "currency": "",
      "end_date": 1740902400,
      "entity_type": "PERSON_PROFILE",
      "fev_info": null,
      "finserv_ad_data": {
        "is_deemed_finserv": false,
        "is_limited_delivery": false
      },
      "gated_type": "ELIGIBLE",
      "has_user_reported": false,
      "hidden_safety_data": false,
      "hide_data_status": "NONE",
      "impressions_with_index": {
        "impressions_text": null,
        "impressions_index": -1
      },
      "is_aaa_eligible": false,
      "is_active": true,
      "is_profile_page": false,
      "menu_items": [],
      "page_id": "367152833370567",
      "page_is_deleted": false,
      "page_name": "Instagram",
      "political_countries": [],
      "publisher_platform": [
        "INSTAGRAM"
      ],
      "reach_estimate": null,
      "regional_regulation_data": {
        "finserv": {
          "is_deemed_finserv": false,
          "is_limited_delivery": false
        },
        "tw_anti_scam": {
          "is_limited_delivery": false
        }
      },
      "report_count": null,
      "snapshot": {
        "body": {
          "text": "Bendito el día que seguí a mi compa en Insta que se la pasa viajando a Japón :) 

#SigueParaConectarMás"
        },
        "branded_content": {
          "current_page_name": "Instagram",
          "page_categories": [
            "App page"
          ],
          "page_id": "367152833370567",
          "page_is_deleted": false,
          "page_name": "Instagram",
          "page_profile_pic_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/476964481_941793684729034_2496972419565164102_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeGVpQiwQpJ6NjZ_r0QRPnRnsuTPvj6vGu2y5M--Pq8a7SAmDJh_-ME6w2hYzLCRUn3LT7Xk_VjtQJJAtf8gTdOz&_nc_ohc=009FNKlR1YYQ7kNvgE4OQoA&_nc_oc=AdjGoiWjyE6GoQ0YBz1it-zYD9Ya-U6JCX3QtXqhWOdDYBx3smRXKKxnS3G2j5h-deg&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AGD5XOOPTiOPhHk7r8BEiFX&oh=00_AYAXW-aXA8Z7HCplfCUjigGwUf-JGvvU4dNdNhvBtD3SUA&oe=67CAD8E6",
          "page_profile_uri": "https://www.facebook.com/instagram/"
        },
        "brazil_tax_id": null,
        "byline": null,
        "caption": "fb.me",
        "cards": [],
        "cta_text": "Learn more",
        "cta_type": "LEARN_MORE",
        "country_iso_code": null,
        "current_page_name": "Lalobri",
        "disclaimer_label": null,
        "display_format": "VIDEO",
        "event": null,
        "images": [],
        "is_reshared": false,
        "link_description": null,
        "link_url": "http://fb.me/1171219090745394",
        "page_categories": [
          "Digital Creator"
        ],
        "page_entity_type": "PERSON_PROFILE",
        "page_id": "378515988682204",
        "page_is_deleted": false,
        "page_is_profile_page": false,
        "page_like_count": 841,
        "page_name": "Lalobri",
        "page_profile_picture_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/476964663_1271062517296994_6188561291427920134_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeHBDvekE5dmCbTMmrY_8dllpDaWWI2JTnykNpZYjYlOfEjNaSaXKVDSg6FoNna0hGRx8p2upelFdTWN2SrOSK_L&_nc_ohc=XXqHzPd3JDgQ7kNvgElJgXd&_nc_oc=Adhe-d488a4U2q_HQFh-j0BuIQ_dlf3bdGYta_SGr4qW9EIAX4VPYU4ZXdVzTv9ivhw&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AGD5XOOPTiOPhHk7r8BEiFX&oh=00_AYDeX8vv11c8n7ix8wy2hYeDFey5jFN4xai6yhTBVyODkg&oe=67CAB11D",
        "page_profile_uri": "https://www.facebook.com/61564084618363/",
        "root_reshared_post": null,
        "title": null,
        "videos": [
          {
            "video_hd_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t42.1790-2/476756415_1627858374528588_2478648308751007555_n.?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeGFMIZfO0nNUHrrpAL4MMzqfhQq5C78fIN-FCrkLvx8gyr-aQF3bhoax7jXSFnJnkAa1X2f8uP1cV86_ByXwtX-&_nc_ohc=5qsq6dJhb7MQ7kNvgEeqawf&_nc_oc=AdjFJYrqg7Ya7UtWHXJTesrcEKaeowoTpYRkxFm9axiczKD5h6mVJMIkrEMEipBTD4k&_nc_zt=28&_nc_ht=scontent.ford4-1.fna&_nc_gid=AGD5XOOPTiOPhHk7r8BEiFX&oh=00_AYC6J64vXFCTqKTPwk1P1-D768j9CaYhyGLRUjTfxfai7g&oe=67CAD6A9",
            "video_preview_image_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/476771066_477630302068939_2551497936913391127_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeExU4fio3Vf0ebVdjAtnPMzkaPcEcZlo92Ro9wRxmWj3T3ipJseK8TTUisJMBn7XLwZPk51OuZPXETva7XYzJCw&_nc_ohc=1SXHcM6R6xsQ7kNvgF5AeKN&_nc_oc=AdiucCHMlY13qIvmCrBNLJ21VNKQFS0bpDmUDmYxIZDPdYeGDz_N-tLCcHSn2_D5JFk&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AGD5XOOPTiOPhHk7r8BEiFX&oh=00_AYBIMeMGBjh3OZlsPD_qkBmLnft-dbpu266dYyaBe4cmIQ&oe=67CAAC25",
            "video_sd_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t42.1790-2/477158098_1295450461504411_8736217373119550609_n.mp4?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeGUQi87HBCOGRBlXIbI8Gv3a5wRn_rBGxVrnBGf-sEbFQ-PtvJoxaduBFa8IBqQr56VwCqO4zdvDGY8BpRuHIJX&_nc_ohc=A2mk0kLNTI4Q7kNvgEDHJfQ&_nc_oc=Adh5t_fnpyBDEzOprcnzBjAb6O8k1sBtjf2yDF0dXgmRNN1N8c8_ZTLZFHyVA8-K4z0&_nc_zt=28&_nc_ht=scontent.ford4-1.fna&_nc_gid=AGD5XOOPTiOPhHk7r8BEiFX&oh=00_AYCP-i5pWooCrOJpA0fdjwBGUbihKLtlBXf5MnKt3dRMKg&oe=67CAAB26",
            "watermarked_video_hd_url": "",
            "watermarked_video_sd_url": ""
          }
        ],
        "additional_info": null,
        "ec_certificates": [],
        "extra_images": [],
        "extra_links": [],
        "extra_texts": [],
        "extra_videos": []
      },
      "spend": null,
      "start_date": 1740643200,
      "state_media_run_label": null,
      "targeted_or_reached_countries": [],
      "total_active_time": null
    }
  ],
  "cursor": "AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Query Parameters

pageId
string

Company Ad Library page ID from Search for Companies. Provide pageId or companyName.

Example:
367152833370567
companyName
string

Company name. Provide companyName or pageId.

Example:
Lululemon
country
string

One two-letter country code, or ALL (default).

Example:
ALL
status
string

Status of the ad. Defaults to ACTIVE.

Example:
ACTIVE
Available options:
ALL,
ACTIVE,
INACTIVE
media_type
string

Ad media type. Defaults to ALL. Meme means an image with text.

Example:
ALL
Available options:
ALL,
IMAGE,
VIDEO,
MEME,
IMAGE_AND_MEME,
NONE
language
string

Two-letter ad language code, such as EN, ES, or FR.

Example:
EN
sort_by
string

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

Example:
total_impressions
Available options:
total_impressions,
relevancy_monthly_grouped
start_date
string

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

Example:
2025-01-01
end_date
string

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

Example:
2025-12-31
trim
boolean

Set true for a trimmed response.

Example:
false
cursor
string

Cursor to paginate through results

Example:
AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP

Response Field Explanations

collation_id
This is Facebook's internal ID for related ads in a campaign
collation_count
The number of ads in the campaign
is_active
Whether the ad is currently running
ad_archive_id
The *actual* ad id