Existing endpoints
See which Facebook or Instagram ads a company is running by providing their website or Facebook page as input.
Adyntel API key
Adyntel account email
Facebook page url (needs to start with https://)
Company website
Parameter used to filter results for a specific country.
Token used to grab the next set of ads
Parameter used to filter results for a specific type of media.
This filters the search in the ad library by active, inactive or all ads.
This will automatically use the continuation_token and scrape all the pages, returning all available ads.
falseWebhook URL where the data will be returned
Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.
Facebook Ad Library response containing ads data
No ads found. You are not charged when you receive this response code.
Missing required parameters
Invalid credentials
Insufficient credits
POST /facebook HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 214
{
"api_key": "text",
"email": "text",
"facebook_url": "text",
"company_domain": "text",
"country_code": "text",
"continuation_token": "text",
"media_type": "image",
"active_status": "inactive",
"all_ads": false,
"webhook_url": "text"
}{
"page_id": "20409006880",
"country_code": "ALL",
"continuation_token": "AQHS1MpoAwYsQCUuqDXYb3EpJsfZ7zpA1-o4eKI5oG1t9l0yzD3m46f-_tvmB7Xx4eoV",
"platform": [
"facebook",
"instagram"
],
"media_types": "all",
"sort_data": "SORT_BY_TOTAL_IMPRESSIONS",
"active_status": "active",
"is_result_complete": false,
"number_of_ads": 2174,
"count_landing_pages": 15,
"unique_landing_pages": [
"https://www.shopify.com/free-trial",
"https://www.shopify.com/fr/essai-gratuit"
],
"start_min_date": null,
"start_max_date": null,
"results": [
[
{
"ad_archive_id": "872866432012637",
"page_id": "20409006880",
"snapshot": {
"page_id": "20409006880",
"page_profile_uri": "https://facebook.com/shopify",
"page_name": "Shopify",
"page_profile_picture_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/615421291_1981551219095546_4134990150595781273_n.jpg?stp=dst-jpg_s60x60_tt6",
"body": {
"text": "Have something to sell? You could have an online store in seconds with our AI store builder."
},
"caption": "shopify.com",
"cards": [
{
"body": "Have something to sell? You could have an online store in seconds with our AI store builder.",
"caption": "shopify.com",
"cta_text": "Sign Up",
"cta_type": "SIGN_UP",
"link_description": "Start your store free",
"link_url": "https://www.shopify.com/free-trial",
"original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/614283238_1415625213504701_6980731558966481326_n.jpg",
"resized_image_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/616155676_920188847106255_6027997119674477867_n.jpg?stp=dst-jpg_s600x600_tt6",
"title": "Describe your store idea and Shopify will help you design it",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null
}
],
"cta_text": "Sign up",
"cta_type": "SIGN_UP",
"current_page_name": "Shopify",
"display_format": "DCO",
"images": [],
"link_description": "Start your store free",
"link_url": "https://www.shopify.com/free-trial",
"page_categories": [
"Software"
],
"page_entity_type": "PERSON_PROFILE",
"page_is_profile_page": false,
"page_like_count": 4525542,
"title": "Describe your store idea and Shopify will help you design it",
"videos": [],
"extra_images": [],
"extra_links": [],
"extra_texts": [],
"extra_videos": []
},
"is_active": true,
"page_name": "Shopify",
"categories": [
"UNKNOWN"
],
"collation_id": "1454621265770589",
"end_date": 1775718000,
"entity_type": "PERSON_PROFILE",
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM",
"MESSENGER"
],
"start_date": 1768291200,
"total_active_time": null
}
]
]
}See which Google ads a company is running by providing their website as input.
Adyntel account email
Adyntel API key
Company website
Filter results based on media type. Possible values: text, image, video.
Token used to grab the next set of ads
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)
falseExtract text content from ad creatives
falseWebhook URL for async delivery
Data provider to use
Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.
Google Ads response containing ads data and total_ad_count
No ads found, or request timed out (60s sync limit)
Missing required parameters
Invalid credentials
Insufficient credits
POST /google HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 190
{
"email": "text",
"api_key": "text",
"company_domain": "text",
"media_type": "text",
"continuation_token": "text",
"all_ads": false,
"extract_text": false,
"webhook_url": "text",
"data_provider": "rapidapi"
}{
"continuation_token": "CgoAP7zmw9QRIgE3EhCHiVZe1u9NriYMDG4AAAAAGgn8+Hkt+LYNqDo=",
"country_code": "anywhere",
"total_ad_count": 4000,
"ads": [
{
"advertiser_id": "AR17828074650563772417",
"creative_id": "CR04542637933743570945",
"original_url": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR04542637933743570945?region=anywhere",
"variants": [
{
"content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/9005246556835217825\" height=\"209\" width=\"364\">",
"height": 209,
"width": 364
}
],
"start": "2026-02-25",
"last_seen": "2026-04-09",
"advertiser_name": "Tesla Inc.",
"format": "Text"
}
]
}See which LinkedIn ads a company is running by providing their website as input.
Adyntel account email
Adyntel API key
LinkedIn Page ID
Company website
Multiple LinkedIn page IDs for batch mode
Multiple company domains for batch mode
Token used to grab the next set of ads
Extract specific data. Use 'number_of_ads' to return only the ad count.
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)
falseOnly return currently active ads
falseWebhook URL where the data will be returned
Data provider to use
Ads retrieved successfully. When webhook_url is provided, returns a job reference instead of ads data.
No ads found, or request timed out (60s sync limit)
Missing required parameters
Invalid credentials
Insufficient credits
POST /linkedin HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 265
{
"email": "text",
"api_key": "text",
"linkedin_page_id": "text",
"company_domain": "text",
"linkedin_page_ids": [
"text"
],
"company_domains": [
"text"
],
"continuation_token": "text",
"extract": "text",
"all_ads": false,
"live_ads": false,
"webhook_url": "text",
"data_provider": "rapidapi"
}{
"page_id": "15564",
"continuation_token": "0#24",
"is_last_page": true,
"total_ads": 16,
"ads": [
{
"creative_type": "SPONSORED_STATUS_UPDATE",
"ad_id": "930315656",
"type": "image",
"advertiser": {
"name": "Tesla",
"logo_url": "https://media.licdn.com/dms/image/v2/C4D0BAQHUcu98SZ2TVw/company-logo_100_100/company-logo_100_100/0/1630576446368/tesla_motors_logo?e=1777507200&v=beta&t=9nMMBNtSM-EmQxdHnCEQGmgSsWLC5nPnX5iEmQXiOeg",
"promoted": true
},
"commentary": {
"text": "At Tesla, we deliver: 39,140% total shareholder return since our IPO – thanks to strong governance and vision."
},
"image": {
"alt_text": "The Future of Tesla",
"url": "https://media.licdn.com/dms/image/v2/D5610AQEc8NBMUUgzyw/image-shrink_1280/B56ZoMoLpQJwAM-/0/1761148452978/ProjectCatalinaSocialPhase4_1080x1080_Ad2-R1png?e=2147483647&v=beta&t=-ddVLCaOIBk4Jo62JXNEf0FsHoA022Wc7NnD9hSdR4o"
},
"carousel": null,
"headline": {
"title": "The Future of Tesla",
"description": "Promoted"
},
"view_details_link": "https://www.linkedin.com/ad-library/detail/930315656?trk=ad_library_ad_preview_content_image",
"raw": null
}
]
}This endpoint runs a search in the LinkedIn Ad Library with the keyword and, optionally, the filters you provide.
Adyntel account email
Adyntel API key
Company website
The 2-digit country code
Valid options: current-month, current-year, custom-date-range, last-30-days, last-year or custom-date-range
YYYY-MM-DD format (e.g. 2026-01-15)
YYYY-MM-DD format (e.g. 2026-01-15)
A token that you can use to scrape the next page
Search results retrieved successfully
LinkedIn Ad Library keyword search results
Invalid dateOption or date format
Invalid credentials
Insufficient credits
Failed to scrape LinkedIn Ad Library
POST /linkedin-keyword-search HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 172
{
"email": "text",
"api_key": "text",
"keyword": "text",
"country": "text",
"dateOption": "current-month",
"startDate": "2026-01-01",
"endDate": "2026-01-01",
"continuation_token": "text"
}{
"total_ads": 5442,
"ads": [
{
"creative_type": "SPONSORED_STATUS_UPDATE",
"ad_id": "1205994913",
"type": "image",
"advertiser": {
"name": "Hamilton Institute - Business Education",
"logo_url": "https://media.licdn.com/dms/image/v2/D4D0BAQFRQvBw2tBEsg/company-logo_100_100/company-logo_100_100/0/1725481615701",
"promoted": true
},
"commentary": {
"text": "Warsztat Praktyczny: \"Inwestowanie w najlepsze firmy i fundusze ETF\""
},
"image": {
"alt_text": "Bezpłatne zapisy",
"url": "https://media.licdn.com/dms/image/v2/D4D10AQHhoo8JBDZs-Q/image-shrink_1280/image-shrink_1280/0/1725957952816/12png"
},
"headline": {
"title": "Bezpłatne zapisy",
"description": "Promoted"
},
"view_details_link": "https://www.linkedin.com/ad-library/detail/1205994913"
}
],
"has_more": true,
"continuation_token": "0#24"
}Find ads in the ad library based on a keyword.
Adyntel account email
Adyntel API key
The keyword you want to use in your search
To limit results to one specific country
Token for paginating through results
Return all ads (auto-paginate)
falseAds matching the keyword retrieved successfully
Facebook Ad Library keyword search results
Missing keyword
Invalid credentials
Insufficient credits
Server error
POST /facebook_ad_search HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 116
{
"email": "text",
"api_key": "text",
"keyword": "text",
"country_code": "text",
"continuation_token": "text",
"all_ads": false
}{
"query": "shopify",
"country_code": "ALL",
"media_types": "all",
"platform": "ALL",
"start_min_date": null,
"start_max_date": null,
"continuation_token": "AQHSdtjnsGEBymxTnM4bSnoNjbOQFOCVGQs-786ShQzSu__qldyqcSRFVeYbSBQX8w7R",
"is_result_complete": false,
"number_of_ads": 50001,
"active_status": "all",
"ad_type": "all",
"search_type": "keyword_unordered",
"results": [
[
{
"ad_archive_id": "1255018519439095",
"page_id": "20409006880",
"snapshot": {
"page_id": "20409006880",
"page_profile_uri": "https://facebook.com/shopify",
"page_name": "Shopify",
"page_profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/526623395_1865327564025629_5303803026642109541_n.jpg?stp=dst-jpg_s60x60_tt6",
"body": {
"text": "Ready to build your store? With Shopify, it’s as easy as drag, drop, done."
},
"caption": "shopify.com",
"cards": [
{
"body": "Ready to build your store? With Shopify, it’s as easy as drag, drop, done.",
"caption": "shopify.com",
"cta_text": "Sign Up",
"cta_type": "SIGN_UP",
"link_description": "Start your free trial",
"link_url": "https://www.shopify.com/start",
"original_image_url": null,
"resized_image_url": null,
"title": "Design and launch your store in minutes",
"video_hd_url": "https://video-iad6-1.xx.fbcdn.net/v/t42.1790-2/525958811_1098562391602216_6901433293664401006_n.",
"video_preview_image_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/526601386_1090295406395495_4070511335277898067_n.jpg",
"video_sd_url": "https://video-iad6-1.xx.fbcdn.net/v/t42.1790-2/474565207_1123059459224111_923856047366217584_n.mp4"
}
],
"cta_text": "Sign up",
"cta_type": "SIGN_UP",
"current_page_name": "Shopify",
"display_format": "DCO",
"images": [],
"link_description": "Start your free trial",
"link_url": "https://www.shopify.com/start",
"page_categories": [
"Software"
],
"page_entity_type": "PERSON_PROFILE",
"page_is_profile_page": false,
"page_like_count": 4526624,
"title": "Design and launch your store in minutes",
"videos": [],
"extra_images": [],
"extra_links": [],
"extra_texts": [],
"extra_videos": []
},
"is_active": true,
"page_name": "Shopify",
"categories": [
"UNKNOWN"
],
"collation_id": "990834986552361",
"end_date": 1775718000,
"entity_type": "PERSON_PROFILE",
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM",
"MESSENGER"
],
"start_date": 1767600000,
"total_active_time": null
}
]
]
}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.
Adyntel API key
Adyntel account email
Company website
When true, use Railway parser for direct synchronous results. When false, use DataForSEO (async, poll with /google_shopping_status).
falseAds retrieved successfully (shopping=true mode)
Task created, poll /google_shopping_status with the returned ID
No ads found
Missing required parameters
Invalid credentials
Insufficient credits
Server error
POST /google_shopping HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 74
{
"api_key": "text",
"email": "text",
"company_domain": "text",
"shopping": false
}{
"ads": [
{
"type": "ads_search",
"rank_group": 1,
"rank_absolute": 1,
"advertiser_id": "AR17828074650563772417",
"creative_id": "CR04542637933743570945",
"title": "Tesla Inc.",
"url": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR04542637933743570945?region=US",
"verified": true,
"format": "text",
"preview_image": {
"url": "https://tpc.googlesyndication.com/archive/simgad/9005246556835217825",
"height": 209,
"width": 364
},
"preview_url": null,
"first_shown": "2026-02-25 21:47:55 +00:00",
"last_shown": "2026-04-09 20:00:29 +00:00"
}
]
}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.
The id you received as response
Adyntel API key
Adyntel account email
Task completed, ads returned
Task still processing
Task completed but no ads found
Invalid credentials
Insufficient credits
POST /google_shopping_status HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 45
{
"id": "text",
"api_key": "text",
"email": "text"
}{
"ads": [
{
"type": "ads_search",
"rank_group": 1,
"rank_absolute": 1,
"advertiser_id": "AR17828074650563772417",
"creative_id": "CR04542637933743570945",
"title": "Tesla Inc.",
"url": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR04542637933743570945?region=US",
"verified": true,
"format": "text",
"preview_image": {
"url": "https://tpc.googlesyndication.com/archive/simgad/9005246556835217825",
"height": 209,
"width": 364
},
"preview_url": null,
"first_shown": "2026-02-25 21:47:55 +00:00",
"last_shown": "2026-04-09 20:00:29 +00:00"
}
]
}Do an ads search on the platform using a keyword.
Your search query
Adyntel API key
Adyntel account email
Use if you want to limit the search to only one country
Ads matching the keyword retrieved successfully
TikTok Ad Library search results
Missing required parameters
Invalid credentials
Insufficient credits
Server error
POST /tiktok_search HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"keyword": "text",
"api_key": "text",
"email": "text",
"country_code": "text"
}{
"data": [
{
"id": "1861945277706417",
"name": "Shopify (USA) Inc.",
"audit_status": "1",
"type": "2",
"first_shown_date": 1775606400000,
"last_shown_date": 1775606400000,
"videos": [
{
"video_url": "https://library.tiktok.com/api/v1/cdn/...",
"cover_img": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okQfNyCloIQLDGBpLBnFIk5EQnDB5mAtugfIn2"
}
],
"estimated_audience": "0-1K",
"spent": "",
"impression": 0,
"show_mode": 1,
"image_urls": [
"https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okQfNyCloIQLDGBpLBnFIk5EQnDB5mAtugfIn2"
],
"rejection_info": null,
"sor_audit_status": "1"
}
],
"total": 1000,
"has_more": true,
"search_id": "2026041004491195861F61736091B71E06",
"code": 0
}Get all the details for an ad on TikTok using the ad id as the starting point.
Ad id
Adyntel API key
Adyntel account email
Ad details retrieved successfully
Detailed TikTok ad information
Missing required parameters
Invalid credentials
Insufficient credits
Server error
POST /tiktok_ad_details HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 45
{
"id": "text",
"api_key": "text",
"email": "text"
}{
"data": {
"ad": {
"id": "1861945277706417",
"name": "Shopify (USA) Inc.",
"audit_status": "1",
"type": "2",
"first_shown_date": 1775606400000,
"last_shown_date": 1775606400000,
"videos": [
{
"video_url": "https://library.tiktok.com/api/v1/cdn/...",
"cover_img": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okQfNyCloIQLDGBpLBnFIk5EQnDB5mAtugfIn2"
}
],
"estimated_audience": "0-1K",
"spent": "",
"impression": 0,
"show_mode": 1,
"image_urls": [
"https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okQfNyCloIQLDGBpLBnFIk5EQnDB5mAtugfIn2"
],
"rejection_info": null,
"sor_audit_status": "1"
},
"advertiser": {
"name": "Shopify (USA) Inc.",
"adv_biz_ids": "6876478549100856065",
"registry_location": "Canada",
"tt_user": {
"username": "shopify",
"display_name": "Shopify",
"avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/ddc03f1bad27e377036ac04f9a3a3aca~tplv-tiktokx-cropcenter:168:168.jpeg",
"follower_count": "1.3M",
"profile_web_link": "https://www.tiktok.com/share/user/6802777718535865350",
"account_type": "BLUEV_BA"
},
"sponsor": "Shopify (USA) Inc."
},
"targeting": {
"location": {
"total_region": 2,
"total_impressions": "0-1K",
"data": [
{
"region": "IE",
"impressions": "0-1K"
},
{
"region": "GB",
"impressions": "0-1K"
}
]
},
"age": [
{
"region": "IE",
"13-17": false,
"18-24": true,
"25-34": true,
"35-44": true,
"45-54": true,
"55+": true
},
{
"region": "GB",
"13-17": false,
"18-24": true,
"25-34": true,
"35-44": true,
"45-54": true,
"55+": true
}
],
"gender": [
{
"region": "IE",
"female": true,
"male": true,
"unknown": true
},
{
"region": "GB",
"female": true,
"male": true,
"unknown": true
}
],
"target_audience_size": "27.2M-33.3M",
"audience": "Yes",
"interest": "",
"video_interactions": "",
"creator_interactions": ""
}
},
"code": 0
}An overview of paid and organic keywords for a domain, with estimation of budgets and CPC included.
Adyntel account email
Adyntel API key
Company website (without www or http)
Language for keyword results
EnglishNumber of results to return
1Keywords analytics retrieved successfully
Percentage distribution for each organic position range and trend (pos_1, pos_2_3, ..., is_new, is_up, is_down, is_lost)
Percentage distribution for paid keyword position ranges and trends
Missing domain
Invalid credentials
Insufficient credits
Server error or API credentials not configured
POST /domain-keywords HTTP/1.1
Host: api.adyntel.com
Content-Type: application/json
Accept: */*
Content-Length: 88
{
"email": "text",
"api_key": "text",
"company_domain": "text",
"language": "English",
"limit": 1
}{
"organic": {
"pos_1": 84603,
"pos_2_3": 31073,
"pos_4_10": 42169,
"pos_11_20": 52779,
"pos_21_30": 75469,
"pos_31_40": 102411,
"pos_41_50": 122143,
"pos_51_60": 139715,
"pos_61_70": 152050,
"pos_71_80": 156048,
"pos_81_90": 151324,
"pos_91_100": 100444,
"count": 1210228,
"is_new": 594045,
"is_up": 297810,
"is_down": 245495,
"is_lost": 0,
"estimated_traffic": 47303330
},
"organic_percentages": {
"pos_1": 6.99,
"pos_2_3": 2.57,
"pos_4_10": 3.48,
"pos_11_20": 4.36,
"pos_21_30": 6.24,
"pos_31_40": 8.46,
"pos_41_50": 10.09,
"pos_51_60": 11.54,
"pos_61_70": 12.56,
"pos_71_80": 12.89,
"pos_81_90": 12.5,
"pos_91_100": 8.3,
"is_new": 49.09,
"is_up": 24.61,
"is_down": 20.29,
"is_lost": 0
},
"paid": {
"pos_1": 15,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"count": 15,
"is_new": 15,
"is_up": 0,
"is_down": 0,
"is_lost": 0,
"estimated_traffic": 2351,
"estimated_ad_budget": 638,
"estimated_avg_cpc": 0.27
},
"paid_percentages": {
"pos_1": 100,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"is_new": 100,
"is_up": 0,
"is_down": 0,
"is_lost": 0
}
}Last updated