Skip to main content
GET
/
v1
/
scrape
/
facebook-ad-library
/
company-ads
Company Ads
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads \
  --header 'X-API-Key: <api-key>'
{
  "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 :) \n\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"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

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

Status of the ad. Defaults to ACTIVE.

Available options:
ALL,
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
media_type
enum<string>

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

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

"ALL"

​
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

Successful response

Key Response Fields:

  • is_active: Whether the ad is currently running
  • ad_archive_id: The actual ad id
​
results
object[]
required
​
cursor
string
required
Example:

"AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP"