Facebook scraper API

Facebook Ad Library Search

Returns structured JSON for Facebook Ad Library Search. Billed $0.00149 per successful call ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. POST with a JSON body works too.

get/api/v1/scrape/facebook/ad-search

Request

  • Base URL: https://hproxy.com
  • URL: https://hproxy.com/api/v1/scrape/facebook/ad-search
  • Auth: API key in header X-API-Key

Query parameters

x-api-keystring required

Your HProxy API key with the scrape scope.

querystring required

Search term or keyword.

sort_bystring

Ordering to apply to the results. Allowed values: total_impressions, relevancy_monthly_grouped.

search_typestring

The search type parameter. Allowed values: keyword_unordered, keyword_exact_phrase.

ad_typestring

The ad type parameter. Allowed values: all, political_and_issue_ads.

countrystring

Two-letter region/country code, e.g. US.

statusstring

The status parameter. Allowed values: ALL, ACTIVE, INACTIVE.

media_typestring

The media type parameter. Allowed values: ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE.

start_datestring

Filter by date, as YYYY-MM-DD.

end_datestring

Filter by date, as YYYY-MM-DD.

cursorstring

Pagination token from the previous response.

trimboolean

Return a slimmed-down payload (drops verbose fields).

Response

Success

object required

Changes

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