facebookAdLibrary

Company Ads

Get all the ads a company has running

get/v1/scrape/facebook-ad-library/company-ads

Request

  • Base URL: https://api.sociavault.com
  • URL: https://api.sociavault.com/v1/scrape/facebook-ad-library/company-ads
  • Auth: API key in header X-API-Key

Query parameters

pageIdstring
Example:367152833370567

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

companyNamestring
Example:Lululemon

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

countrystring
Example:ALL

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

status'ALL' | 'ACTIVE' | 'INACTIVE'
Example:ACTIVE

Status of the ad. Defaults to ACTIVE.

media_type'ALL' | 'IMAGE' | 'VIDEO' | 'MEME' | 'IMAGE_AND_MEME' | 'NONE'
Example:ALL

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

languagestring
Example:EN

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

start_datestring
Example:2025-01-01

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

end_datestring
Example:2025-12-31

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

cursorstring
Example:AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP

Cursor to paginate through results

trimboolean

Set to true for a trimmed down version of the response

Response

Successful response

Key Response Fields:

  • is_active: Whether the ad is currently running
  • ad_archive_id: The actual ad id

Changes

No recorded changes to this operation across all 1 revision of this API.