Existing endpoints

Facebook & Instagram Ads

post

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

Body
api_keystringRequired

Adyntel API key

emailstringRequired

Adyntel account email

facebook_urlstringOptional

Facebook page url (needs to start with https://)

company_domainstringOptional

Company website

country_codestringOptional

Parameter used to filter results for a specific country.

continuation_tokenstringOptional

Token used to grab the next set of ads

media_typestring · enumOptional

Parameter used to filter results for a specific type of media.

Possible values:
active_statusstring · enumOptional

This filters the search in the ad library by active, inactive or all ads.

Possible values:
all_adsbooleanOptional

This will automatically use the continuation_token and scrape all the pages, returning all available ads.

Default: false
webhook_urlstringOptional

Webhook URL where the data will be returned

Responses
200

Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.

application/json
objectOptional

Facebook Ad Library response containing ads data

or
post
/facebook

Google Ads

post

See which Google ads a company is running by providing their website as input.

Body
emailstringRequired

Adyntel account email

api_keystringRequired

Adyntel API key

company_domainstringRequired

Company website

media_typestring · enumOptional

Filter results based on media type. Possible values: text, image, video.

Possible values:
continuation_tokenstringOptional

Token used to grab the next set of ads

all_adsbooleanOptional

This will automatically use the continuation_token and scrape all the pages, returning all available ads. Works only with a webhook_url as it needs a place to send each page, one by one. Warning: use this cautiously because there is no way of stopping it. If you use this on a domain that runs 10000 ads, it will try to scrape all the ads and it will use the credits (one page = one credit)

Default: false
extract_textbooleanOptional

Extract text content from ad creatives

Default: false
webhook_urlstringOptional

Webhook URL for async delivery

data_providerstring · enumOptional

Data provider to use

Possible values:
Responses
200

Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.

application/json
objectOptional

Google Ads response containing ads data and total_ad_count

or
post
/google

LinkedIn Ads

post

See which LinkedIn ads a company is running by providing their website as input.

Body
emailstringRequired

Adyntel account email

api_keystringRequired

Adyntel API key

linkedin_page_idstringOptional

LinkedIn Page ID

company_domainstringOptional

Company website

linkedin_page_idsstring[]Optional

Multiple LinkedIn page IDs for batch mode

company_domainsstring[]Optional

Multiple company domains for batch mode

continuation_tokenstringOptional

Token used to grab the next set of ads

extractstringOptional

Extract specific data. Use 'number_of_ads' to return only the ad count.

all_adsbooleanOptional

This will automatically use the continuation_token and scrape all the pages, returning all available ads. Works only with a webhook_url as it needs a place to send each page, one by one. Warning: use this cautiously because there is no way of stopping it. If you use this on a domain that runs 10000 ads, it will try to scrape all the ads and it will use the credits (one page = one credit)

Default: false
live_adsbooleanOptional

Only return currently active ads

Default: false
webhook_urlstringOptional

Webhook URL where the data will be returned

data_providerstring · enumOptional

Data provider to use

Possible values:
Responses
200

Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.

application/json
or
post
/linkedin

LinkedIn Keyword Search

post

This endpoint runs a search in the LinkedIn Ad Library with the keyword and, optionally, the filters you provide.

Body
emailstringRequired

Adyntel account email

api_keystringRequired

Adyntel API key

keywordstringRequired

Company website

countrystringOptional

The 2-digit country code

dateOptionstring · enumOptional

Valid options: current-month, current-year, custom-date-range, last-30-days, last-year or custom-date-range

Possible values:
startDatestring · dateOptional

YYYY-MM-DD format (e.g. 2026-01-15)

endDatestring · dateOptional

YYYY-MM-DD format (e.g. 2026-01-15)

continuation_tokenstringOptional

A token that you can use to scrape the next page

Responses
200

Search results retrieved successfully

application/json
objectOptional

LinkedIn Ad Library keyword search results

post
/linkedin-keyword-search

Meta Ad Search

post

Find ads in the ad library based on a keyword.

Body
emailstringRequired

Adyntel account email

api_keystringRequired

Adyntel API key

keywordstringRequired

The keyword you want to use in your search

country_codestringOptional

To limit results to one specific country

continuation_tokenstringOptional

Token for paginating through results

all_adsbooleanOptional

Return all ads (auto-paginate)

Default: false
Responses
200

Ads matching the keyword retrieved successfully

application/json
objectOptional

Facebook Ad Library keyword search results

post
/facebook_ad_search

Google Shopping Ads

post

Retrieve all Google shopping ads for a specified company by providing their domain. This differs from the standard Google endpoint, which reports search, image, and video ads on Google's platform.

Body
api_keystringRequired

Adyntel API key

emailstringRequired

Adyntel account email

company_domainstringRequired

Company website

shoppingbooleanOptional

When true, use Railway parser for direct synchronous results. When false, use DataForSEO (async, poll with /google_shopping_status).

Default: false
Responses
200

Ads retrieved successfully (shopping=true mode)

application/json
adsobject[]Optional
post
/google_shopping

Google Shopping Status

post

Retrieve results from a Google Shopping search using a request ID obtained from the initial Google Shopping endpoint call. The service is free to use.

Body
idstringRequired

The id you received as response

api_keystringRequired

Adyntel API key

emailstringRequired

Adyntel account email

Responses
200

Task completed, ads returned

application/json
adsobject[]Optional
post
/google_shopping_status

TikTok Ad Search

post

Do an ads search on the platform using a keyword.

Body
keywordstringRequired

Your search query

api_keystringRequired

Adyntel API key

emailstringRequired

Adyntel account email

country_codestringOptional

Use if you want to limit the search to only one country

Responses
200

Ads matching the keyword retrieved successfully

application/json
objectOptional

TikTok Ad Library search results

post
/tiktok_search

TikTok Ad Details

post

Get all the details for an ad on TikTok using the ad id as the starting point.

Body
idstringRequired

Ad id

api_keystringRequired

Adyntel API key

emailstringRequired

Adyntel account email

Responses
200

Ad details retrieved successfully

application/json
objectOptional

Detailed TikTok ad information

post
/tiktok_ad_details

Paid vs Organic Keywords

post

An overview of paid and organic keywords for a domain, with estimation of budgets and CPC included.

Body
emailstringRequired

Adyntel account email

api_keystringRequired

Adyntel API key

company_domainstringRequired

Company website (without www or http)

languagestringOptional

Language for keyword results

Default: English
limitintegerOptional

Number of results to return

Default: 1
Responses
200

Keywords analytics retrieved successfully

application/json
organic_percentagesobjectOptional

Percentage distribution for each organic position range and trend (pos_1, pos_2_3, ..., is_new, is_up, is_down, is_lost)

paid_percentagesobjectOptional

Percentage distribution for paid keyword position ranges and trends

post
/domain-keywords

Last updated