POST /api/fbads/lists — advertisers from the Facebook Ad Library with their page, ads count, website and email.
| Field | Type | Notes |
|---|---|---|
mode | string | "search" (keyword + country) or "url" (an Ad Library link). Default search. |
keyword | string | Words in the ads (search mode). |
url | string | An Ad Library URL (url mode). |
country | string | Two-letter code (54 supported, e.g. US, GB, CA, AU, DE, FR, IN, BR…). |
maxResults | integer | 1–1000 ads read. Default 100. |
filters.activeStatus | string | ACTIVE, ALL or INACTIVE. Default ACTIVE. |
filters.adType | string | ALL, POLITICAL_AND_ISSUE_ADS, HOUSING, EMPLOYMENT, CREDIT. Default ALL. |
filters.searchType | string | KEYWORD_UNORDERED or KEYWORD_EXACT_PHRASE. Default KEYWORD_UNORDERED. |
curl -X POST https://prospectcheap.com/api/fbads/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"mode":"search","keyword":"roof replacement","country":"US","maxResults":100,"filters":{"activeStatus":"ACTIVE"}}'Then
The response has list.id. Poll GET /api/fbads/lists/{id} until list.status is completed (or failed); the results are under pages. See Search Status, Filter & Paginate and Export CSV.
Credits: one per result found. The most the search could cost is reserved when it starts; what isn't used comes back when it finishes.