Facebook Ad Library Company Ads API

Get all the ads a company has running. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send 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

The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName

Example:
367152833370567
companyName
string

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

Example:
Lululemon
country
string

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

Example:
ALL
status
string

Status of the ad. Defaults to ACTIVE.

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

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

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

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

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
cursor
string

Cursor to paginate through results

Example:
AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP
trim
boolean

Set to true for a trimmed down version of the response

Example:
false

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