Scrapecreators · Social

Scrape Creators API / Search

Searches the Meta Ad Library by keyword and returns matching ads. Supports filtering by language with a 2-letter code such as EN or ES. Each result includes adarchiveid, pagename, isactive, publisherplatform, and a snapshot with body text, images, videos, and ctatext. Both GET and POST are supported. 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.

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

ad_type body · optional
Search for all ads or only political and issue ads
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
Impressions end date. Needs to be in YYYY-MM-DD format.
language body · optional
Language to filter ads on. Needs to be a 2 letter language code, such as EN, ES, or FR.
media_type body · optional
Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.
query body · required
Keyword to search for
search_type body · optional
If you want to search by exact phrase or not
sort_by body · optional
Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
start_date body · optional
Impressions start date. Needs to be in YYYY-MM-DD format.
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