Scrapecreators · Social

Scrape Creators API / Company Ads

Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes adarchiveid, pagename, isactive, publisherplatform, and a snapshot with body, images, videos, and displayformat. Supports filtering by country, media_type, date range, and language with cursor-based pagination. Both GET and POST are supported. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

companyName body · optional
The name of the company. Can either use this or pageId
country body · optional
This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
cursor body · optional
Cursor to paginate through results
end_date body · optional
End date to search for. Format: YYYY-MM-DD
language body · optional
Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc
media_type body · optional
Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.
pageId body · optional
The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName
sort_by body · optional
Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
start_date body · optional
Start date to search for. Format: YYYY-MM-DD
status body · optional
Status of the ad. Defaults to ACTIVE.
trim body · optional
Set to true for a trimmed down version of the response

Provider docs How to run it