search

Meta

circle-check

You first need to create an account, you can sign up herearrow-up-right to receive 50 credits to test it out.

The Facebook & Instagram endpoint allows you find all Facebook and Instagram ads for a given company.

It takes a Facebook page or a company domain as input.

circle-exclamation

Company domain has to be passed in the 'company.com' format, meaning all prefixes like 'https://' or 'www.' need to be removed.

hashtag

hashtag
API endpoint

POST api.adyntel.com/facebook

See which Facebook or Instagram ads a company is running by providing their website or Facebook page as input.

hashtag
Headers

Name
Value
Required

Content-Type

application/json

hashtag
Body

Name
Type
Description
Required

api_key

string

Adyntel API key

email

number

Adyntel account email

facebook_url

string

Facebook page url (needs to start with https://) Either this or company_domain is required.

company_domain

string

Company website Either this or facebook_url is required.

webhook_url

string

Webhook URL where the data will be returned

continuation_token

string

Token used to grab the next set of ads

media_type

string

Parameter used to filter results for a specific type of media. Possible values: image, meme, image_and_meme, video

country_code

string

Parameter used to filter results for a specific country. See possible list of values below.

active_status

string

This filters the search in the ad library by active, inactive or all ads. If this is not added the endpoint returns, by default, just active ads. Possible values: inactive (to get just the inactive ads) and all (to get both the active and inactive ads)

chevron-rightList of possible values for the country_code parameter: hashtag

AL | DZ | AS | AD | AO | AQ | AG | AR | AM | AU | AT | AZ | BH | BD | BB | BY | BE | BZ | BJ | BT | BO | BA | BW | BR | BN | BG | BF | BI | KH | CM | CA | CV | BQ | CF | TD | CL | CN | CX | CC | CO | KM | CK | CR | CI | HR | CW | CY | CZ | CD | DK | DJ | DM | DO | EC | EG | SV | GQ | ER | EE | SZ | ET | FM | FJ | FI | FR | PF | TF | GA | GE | DE | GH | GR | GD | GU | GT | GG | GN | GW | GY | HT | HM | HN | HU | IS | IN | ID | IQ | IE | IL | IT | JM | JP | JE | JO | KZ | KE | KI | KW | KG | LA | LV | LB | LS | LR | LY | LI | LT | LU | MG | MW | MY | MV | MT | ML | MH | MR | MU | MX | MD | MC | MN | ME | MA | MZ | MM | NA | NR | NP | NL | NC | NZ | NI | NE | NG | NU | NF | MK | MP | NO | OM | PK | PW | PA | PG | PY | PE | PH | PN | PL | PT | QA | CG | RO | RW | SH | KN | LC | PM | VC | WS | SM | ST | SA | SN | SC | SL | SG | SX | SK | SI | SB | SO | ZA | GS | KR | ES | LK | SR | CH | SE | TJ | TZ | TH | BS | GM | TL | TG | TK | TO | TT | TN | TR | TM | TV | UG | UA | AE | GB | US | UY | UZ | VU | VA | VE | VN | YE | ZM | ZW | BM | BV | IO | VG | IC | KY | TW | YT | FO | FK | GF | PS | GI | GL | GP | HK | IM | MO | MQ | MS | AW | PR | RE | AI | EH | MF | SJ | TC | UM | VI | WF

hashtag
Example request

  • Request made using company_domain:

  • Request made using facebook_url:

  • Request made using webhooks (works with both company_domain and facebook_url):

When you're using webhooks the data will be sent to the webhook URL and you will receive a different response to your call:

  • Request made using continuation_token. You receive this token in the first call you make, but only if there are more ads than we were able to retrieve (usually we get the first 30 ads). If you use this in your next call we will give you the next set of ads (next 30) and, if there are more ads, you will receive another continuation_token that you can use to grab the next set of ads etc. This continues until the last page of ads where the response you get will have a "null" continuation_token.

hashtag
Possible responses

hashtag
204

There are multiple situations in which the response code will be 204 with no message. This happens when:

  • the domain provided returns a HTML response different than 200. That usually happens if the website could be loaded, it is not available, domain is expired etc.

  • we scrape the domain provided but there is no Facebook URL on it so there is no way to move to the next step

  • we scraped the Facebook URL but the page is not publicly available so it cannot be scraped

You are not charged when you receive this response code.

hashtag
Full response, with ads

Example response

hashtag
Attributes

  • active_status (string) Indicates whether the ad campaign is currently active.

  • continuation_token (nullable string) Token used for pagination to retrieve the next set of results, if applicable.

  • country_code (string) The ISO code of the country where the ads are displayed.

  • is_result_complete (boolean) Indicates if the result set is complete or if more data is available.

  • media_types (string) Types of media included in the ads, such as images or videos.

  • number_of_ads (integer) Total number of ads returned in the response.

  • page_id (string) Unique identifier for the Facebook page associated with the ads.

  • platform (array of strings) Platforms where the ads are running, e.g., Facebook, Instagram.

  • results (array of objects) Contains detailed information about each ad.

  • adArchiveID (string) Unique identifier for the ad in the archive.

  • adid (string) Identifier for the ad itself.

  • archiveTypes (array) Types of archives associated with the ad, if any.

  • categories (array of integers) Categories assigned to the ad for classification purposes.

  • collationCount (integer) Number of times this ad has been collated or grouped with others.

  • collationID (integer) Identifier for the collation group this ad belongs to.

  • containsDigitallyCreatedMedia (boolean) Indicates if the ad contains digitally created media content.

  • containsSensitiveContent (boolean) Indicates if the ad contains sensitive content that may require special handling.

  • currency (string) Currency used in any financial data related to the ad, if applicable.

  • endDate (integer) Unix timestamp representing when the ad campaign ends.

  • entityType (string) Type of entity associated with the ad, such as a person or business profile.

  • fevInfo (nullable object) Additional information related to Facebook's ad review process.

  • finServAdData (object) Contains information about financial service advertisements.

  • gatedType (string) Eligibility status of the ad for certain features or audiences.

  • hasUserReported (boolean) Indicates if any users have reported this ad for review or issues.

  • hiddenSafetyData (boolean) Indicates if there is any safety data that is hidden from view.

  • hideDataStatus (string) Status indicating whether any data related to this ad is hidden from public view.

  • impressionsWithIndex (object) Contains information about ad impressions.

  • isAAAEligible (boolean) Indicates eligibility for AAA (Audience and Ad Analysis) features.

  • isActive (boolean) Indicates whether the ad is currently active and running.

  • isAdAccountActioned (boolean) Indicates if any actions have been taken on this ad by account administrators.

  • isProfilePage (boolean) Indicates if this ad is associated with a profile page rather than a business page.

  • menuItems (array) Array of menu items associated with this ad's context or placement.

  • pageID (string) Identifier for the Facebook page that owns this ad.

  • pageInfo (nullable object) Additional information about the page associated with the ad.

  • pageIsDeleted (boolean) Indicates whether the page associated with this ad has been deleted.

  • pageName (string) Name of the Facebook page associated with this ad.

  • politicalCountries (array) List of countries where this ad is classified as political content.

  • publisherPlatform (array of strings) Platforms where this ad is published and visible to users.

  • reachEstimate (nullable object) Estimated reach of this ad in terms of audience size or demographics, if available.

  • reportCount (nullable integer) Number of reports or complaints filed against this ad by users or moderators.

  • snapshot (object) Contains detailed information about the ad creative, including body, images, and call-to-action details.

  • spend (nullable object) Financial spend data related to this ad campaign, if available.

  • startDate (integer) Unix timestamp representing when the ad campaign starts or started running.

  • stateMediaRunLabel (nullable string) Label indicating media run state or status for regulatory purposes, if applicable.

  • totalActiveTime (nullable integer) Total active time duration for which this ad has been running since its start date.

PreviousExtracting LinkedIn page idNextMeta ad search

Last updated