Facebook scraper API

Facebook Company Ads

Returns structured JSON for Facebook Company Ads. 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-company

Request

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

Query parameters

x-api-keystring required

Your HProxy API key with the scrape scope.

pageIdstring required

Identifier from a previous response. Send this or companyName.

companyNamestring required

The companyName parameter. Send this or pageId.

countrystring

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

statusstring

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

languagestring

Two-letter language code, e.g. en.

cursorstring

Pagination token from the previous response.

media_typestring

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

sort_bystring

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

start_datestring

Filter by date, as YYYY-MM-DD.

end_datestring

Filter by date, as YYYY-MM-DD.

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.