### Example Tool Interaction Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Example prompt for searching Facebook ads using the integrated tools. ```text Search for Facebook ads from nike.com ``` -------------------------------- ### Competitor Analysis Workflow Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Example multi-step prompt for analyzing competitor advertising strategies. ```text 1. Search for Facebook ads from my competitor acme.com 2. Search for their Google Ads as well 3. Summarize their messaging strategy and key value propositions ``` -------------------------------- ### Multi-Platform Overview Prompt Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Example prompt for gathering a comprehensive view of advertising across multiple platforms. ```text Give me a comprehensive view of Shopify's advertising: - Their Facebook ads - Their Google Ads - Their LinkedIn ads Summarize the differences in messaging across platforms. ``` -------------------------------- ### Google Ads API Request Example Source: https://docs.adyntel.com/ad-libraries/google This is an example of a POST request to the Google Ads API endpoint. It includes the necessary api_key, email, and company_domain parameters to retrieve ads for a specific company. ```json { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "company_domain": "clay.com" } ``` -------------------------------- ### Handle Paginated Results Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Example prompt for fetching additional results using a continuation token. ```text Get more Facebook ads from Nike using continuation token: xyz789 ``` -------------------------------- ### Example JSON Response Source: https://docs.adyntel.com/ad-libraries/google-shopping-status The response contains an array of ad objects, each with unique identifiers and metadata. ```json { "ads": [ { "advertiser_id": "AR11920289341835837441", "creative_id": "CR15157585378866626561", "first_shown": "2024-02-27 01:02:34 +00:00", "format": "text", "last_shown": "2024-12-17 17:07:32 +00:00", "preview_image": { "height": 173, "url": "https://tpc.googlesyndication.com/archive/simgad/9720546471572168024", "width": 380 }, "preview_url": null, "rank_absolute": 1, "rank_group": 1, "title": "iHerb, LLC", "type": "ads_search", "url": "https://adstransparency.google.com/advertiser/AR11920289341835837441/creative/CR15157585378866626561?region=US", "verified": true }, { "advertiser_id": "AR11920289341835837441", "creative_id": "CR05228418239523979265", "first_shown": "2022-07-13 20:02:36 +00:00", "format": "image", "last_shown": "2024-12-17 16:44:57 +00:00", "preview_image": { "height": null, "url": null, "width": null }, "preview_url": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=5208869368&creativeId=610290732130&uiFeatures=12,54&adGroupId=138505634763&itemIds=16818768607040223757&overlay=%3DH4sIAAAAAAAAALMSMxLhEuLk3SVv98El46Ugw-GIvZoOE3Z6yXAJJBcXu2QWF-QkVgaXFGXmpQtxcLG55-en56R6qXJJFGfkFxQARR1T_NPSUouci1ITSzLLUg2EOK3YOdZxCjExM3mp4FRmKMRhxcbxi0mIkRGPKiOwqqecQozcXoo4VRkLsVoxczRzAwAdeFwyzAAAAA&sig=ACiVB_yfh_O1jCJMqonDTbquBzNGW8H76Q&htmlParentId=fletch-render-9058006553094161367&responseCallback=fletchCallback9058006553094161367", "rank_absolute": 2, "rank_group": 2, "title": "iHerb, LLC", "type": "ads_search", "url": "https://adstransparency.google.com/advertiser/AR11920289341835837441/creative/CR05228418239523979265?region=US", "verified": true }, { "advertiser_id": "AR11920289341835837441", "creative_id": "CR10533706051365109761", "first_shown": "2024-04-10 08:45:55 +00:00", "format": "text", "last_shown": "2024-12-17 16:43:19 +00:00", "preview_image": { "height": 167, "url": "https://tpc.googlesyndication.com/archive/simgad/6978354592820282403", "width": 380 }, "preview_url": null, "rank_absolute": 3, "rank_group": 3, "title": "iHerb, LLC", "type": "ads_search", "url": "https://adstransparency.google.com/advertiser/AR11920289341835837441/creative/CR10533706051365109761?region=US", "verified": true }, { "advertiser_id": "AR11920289341835837441", "creative_id": "CR01119462094463303681", "first_shown": "2024-04-10 06:07:15 +00:00", "format": "text", "last_shown": "2024-12-17 16:29:54 +00:00", "preview_image": { "height": 173, "url": "https://tpc.googlesyndication.com/archive/simgad/14664131898075640092", "width": 380 }, "preview_url": null, "rank_absolute": 4, "rank_group": 4, "title": "iHerb, LLC", "type": "ads_search", "url": "https://adstransparency.google.com/advertiser/AR11920289341835837441/creative/CR01119462094463303681?region=US", "verified": true }, { "advertiser_id": "AR11920289341835837441", "creative_id": "CR11000426059928698881", "first_shown": "2024-04-10 17:25:52 +00:00", "format": "text", "last_shown": "2024-12-17 16:25:01 +00:00", "preview_image": { "height": 167, "url": "https://tpc.googlesyndication.com/archive/simgad/6311364290513919268", "width": 380 }, "preview_url": null, "rank_absolute": 5, "rank_group": 5, "title": "iHerb, LLC", "type": "ads_search", "url": "https://adstransparency.google.com/advertiser/AR11920289341835837441/creative/CR11000426059928698881?region=US", "verified": true }, { "advertiser_id": "AR11920289341835837441", "creative_id": "CR17434546554080854017", "first_shown": "2024-04-10 18:18:12 +00:00", "format": "text", "last_shown": "2024-12-17 16:20:16 +00:00", "preview_image": { "height": 173, ``` -------------------------------- ### Start tracking a competitor Source: https://docs.adyntel.com/integrations/using-adyntel-in-slack Create a new tracking job to monitor a competitor's ads on a specific platform and frequency. ```text /adyntel track add competitor.com facebook daily ``` -------------------------------- ### Full Ad Response Example Source: https://docs.adyntel.com/ad-libraries/meta This JSON object represents a complete response from the Adyntel API, detailing ad campaign information, targeting parameters, and a list of ads with their content and metadata. It includes pagination tokens and counts for ads and landing pages. ```json { "page_id": "7172307686", "country_code": "ALL", "continuation_token": "AQHSxHvUKdkvgxfh6ESFEPpsUrDsh2rC206kS2Rw4kvD1DpX8R_Qk7zpIEiVAZ_L95Y3", "platform": [ "facebook", "instagram" ], "media_types": "all", "sort_data": "SORT_BY_TOTAL_IMPRESSIONS", "active_status": "active", "is_result_complete": false, "number_of_ads": 32, "count_landing_pages": 24, "unique_landing_pages": [ "https://www.zappos.com/", "https://www.zappos.com/running-shoes/CK_XARC81wEY0O4B4gIEMAECA4IDA_vzAQ.zso", "https://www.zappos.com/running-shoes/CK_XARC81wEY0O4B4gIEMAECA4IDA-HyAQ.zso", "https://www.zappos.com/product/7165047/color/72", "https://www.zappos.com/null/4gIBMIIDA_LzAQ.zso", "https://www.zappos.com/product/7165047/color/17887", "https://www.zappos.com/product/7190382/color/3", "https://www.zappos.com/product/7182725/color/3", "https://www.zappos.com/product/102181/color/115", "https://www.zappos.com/men-sandals/CK_XARC51wHAAQLiAgMBAhg.zso", "https://www.zappos.com/product/101191/color/3", "https://www.zappos.com/hoka-women-shoes/CK_XAWIClxrAAQHiAgMBDBg.zso", "https://www.zappos.com/null/4gIBMIIDA_TzAQ.zso", "https://www.zappos.com/null/4gIBMIIDA-vzAQ.zso", "https://www.zappos.com/women-sandals/CK_XARC51wHAAQHiAgMBAhg.zso", "https://www.zappos.com/hoka-men-shoes/CK_XAWIClxrAAQLiAgMBDBg.zso", "https://www.zappos.com/on-men-shoes/CK_XAWICxh_AAQLiAgMBDBg.zso", "https://www.zappos.com/product/7158233/color/28", "https://www.zappos.com/shoes/CK_XAeICAjABggMDzfMB.zso", "https://www.zappos.com/shoes/CK_XAeICAjABggMD-vMB.zso", "https://www.zappos.com/product/101026/color/3", "https://www.zappos.com/null/4AEB4gIBHA.zso", "https://www.zappos.com/product/102179/color/3", "https://www.zappos.com/product/7212450/color/6" ], "start_min_date": null, "start_max_date": null, "results": [ [ { "ad_archive_id": "1856457768340957", "page_id": "7172307686", "snapshot": { "page_id": "7172307686", "page_profile_uri": "https://facebook.com/zappos", "page_name": "Zappos.com", "page_profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/605229556_1264083579073773_276540164055197950_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=e5KNf6wr9y0Q7kNvwERYJOq&_nc_oc=Adlg1aQ9JNq37HXi9taAUvrOnjmNuIkXxF-PjSyDNqAuY7SRN4u9C325vT9XKiZu71I&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfygILxqU2DARZex4ZagUSLz5lCp_AJw41e6vg0sROGYAg&oe=69B7CCF0", "body": { "text": "This season's must haves, only at Zappos. \ud83d\udc62" }, "caption": "zappos.com", "cards": [ { "body": "This season's must haves, only at Zappos. \ud83d\udc62", "caption": "zappos.com", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "Fast, FREE shipping on just-landed sneakers, boots, heels & more from your favorite brands. Now that's a win.", "link_url": "https://www.zappos.com/product/7165047/color/72", "original_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/603869031_834904779519512_2011076685899997798_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xxFE2xDErBEQ7kNvwEnnxq_&_nc_oc=Adks6s8JAN7HcjgRSt2mvvSJMDXd7qWdvOkWj03fX-ZX7_uK3DA49wez8w-ocehryRM&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfwpbThY9L_wORO2GZEx3KIE5gvJbnW7gvg_QG_o5RcGgQ&oe=69B7D13F", "resized_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/603869031_834904779519512_2011076685899997798_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xxFE2xDErBEQ7kNvwEnnxq_&_nc_oc=Adks6s8JAN7HcjgRSt2mvvSJMDXd7qWdvOkWj03fX-ZX7_uK3DA49wez8w-ocehryRM&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfzrOqTwo6ly7XCDkYB6hOOJh-nu7n0AsmFTPPXJwpE6nQ&oe=69B7D13F", "watermarked_resized_image_url": "", "title": "Frye Campus 14L Cowboy Women's Boots Black Leather : 8 B - Medium", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_video_hd_url": null } ] } } ] ] } ``` -------------------------------- ### JobStartedResponse Object Source: https://docs.adyntel.com/openapi-docs/existing-endpoints Represents the response object when a job is successfully started. ```APIDOC ## JobStartedResponse Object ### Description Represents the response object when a job is successfully started. ### Properties - **status** (string) - The status of the job. - **jobId** (string) - Unique job ID. Track via GET /track/jobs and /track/results. ``` -------------------------------- ### Google Shopping API Request Example Source: https://docs.adyntel.com/ad-libraries/google-shopping Use this JSON payload to request Google shopping ads for a company. Ensure the 'company_domain' is in the 'company.com' format. ```json { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "company_domain": "tesla.com" } ``` -------------------------------- ### Perform Meta Ad Search Request Source: https://docs.adyntel.com/ad-libraries/meta-ad-search Example request body for searching ads with a specific keyword and country code. ```json { "api_key": "your_api_key", "email": "your_email", "keyword": "webinar", "country_code": "US" } ``` -------------------------------- ### Ad Creative Research Prompt Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Example prompt for retrieving and analyzing video ads. ```text Find all video ads from Nike on Facebook. I want to analyze their video creative approach. ``` -------------------------------- ### URL-encoded Email Example Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Use this format when special characters in an email address cause authentication failures. ```text email=user%2Btest@example.com ``` -------------------------------- ### GET /websites/adyntel Source: https://docs.adyntel.com/ad-libraries/meta Retrieves a full response of ads for a given website, including detailed ad information and metadata. ```APIDOC ## GET /websites/adyntel ### Description Retrieves a comprehensive list of ads associated with a specific website, including detailed ad content, platform information, and engagement metrics. ### Method GET ### Endpoint /websites/adyntel ### Query Parameters - **page_id** (string) - Required - The unique identifier for the page or website. - **country_code** (string) - Optional - Filters ads by country code. - **continuation_token** (string) - Optional - Used for paginating through results. - **platform** (string) - Optional - Filters ads by platform (e.g., 'facebook', 'instagram'). - **media_types** (string) - Optional - Filters ads by media type (e.g., 'all', 'image', 'video'). - **sort_data** (string) - Optional - Specifies the sorting order for results (e.g., 'SORT_BY_TOTAL_IMPRESSIONS'). - **active_status** (string) - Optional - Filters ads by their active status (e.g., 'active'). - **is_result_complete** (boolean) - Optional - Indicates if the result set is complete. - **number_of_ads** (integer) - Optional - Specifies the number of ads to retrieve. - **count_landing_pages** (integer) - Optional - Specifies the count of unique landing pages. - **unique_landing_pages** (array) - Optional - A list of unique landing page URLs. - **start_min_date** (string) - Optional - Filters ads starting from a minimum date. - **start_max_date** (string) - Optional - Filters ads ending by a maximum date. ### Response #### Success Response (200) - **page_id** (string) - The unique identifier for the page. - **country_code** (string) - The country code associated with the ads. - **continuation_token** (string) - Token for fetching the next page of results. - **platform** (array) - List of platforms the ads are running on. - **media_types** (string) - The type of media used in the ads. - **sort_data** (string) - The sorting criteria applied to the results. - **active_status** (string) - The active status of the ads. - **is_result_complete** (boolean) - Indicates if all results have been returned. - **number_of_ads** (integer) - The total number of ads found. - **count_landing_pages** (integer) - The count of unique landing pages. - **unique_landing_pages** (array) - A list of unique landing page URLs. - **start_min_date** (string) - The minimum start date for the ads. - **start_max_date** (string) - The maximum start date for the ads. - **results** (array) - An array containing ad data. - **ad_archive_id** (string) - The unique ID of the ad in the archive. - **page_id** (string) - The ID of the page the ad belongs to. - **snapshot** (object) - Contains details about the ad's snapshot. - **page_id** (string) - The page ID within the snapshot. - **page_profile_uri** (string) - The URI of the page profile. - **page_name** (string) - The name of the page. - **page_profile_picture_url** (string) - URL of the page's profile picture. - **body** (object) - The main content of the ad. - **text** (string) - The text content of the ad body. - **caption** (string) - The caption of the ad. - **cards** (array) - An array of ad cards. - **body** (string) - The body text of the card. - **caption** (string) - The caption of the card. - **cta_text** (string) - The call-to-action text. - **cta_type** (string) - The type of call-to-action. - **link_description** (string) - Description of the linked content. - **link_url** (string) - The URL the card links to. - **original_image_url** (string) - URL of the original ad image. - **resized_image_url** (string) - URL of the resized ad image. - **title** (string) - The title of the card. - **video_hd_url** (string) - URL for the HD version of the video. - **video_preview_image_url** (string) - URL for the video preview image. - **video_sd_url** (string) - URL for the SD version of the video. - **watermarked_video_hd_url** (string) - URL for the watermarked HD video. ### Response Example ```json { "page_id": "7172307686", "country_code": "ALL", "continuation_token": "AQHSxHvUKdkvgxfh6ESFEPpsUrDsh2rC206kS2Rw4kvD1DpX8R_Qk7zpIEiVAZ_L95Y3", "platform": [ "facebook", "instagram" ], "media_types": "all", "sort_data": "SORT_BY_TOTAL_IMPRESSIONS", "active_status": "active", "is_result_complete": false, "number_of_ads": 32, "count_landing_pages": 24, "unique_landing_pages": [ "https://www.zappos.com/", "https://www.zappos.com/running-shoes/CK_XARC81wEY0O4B4gIEMAECA4IDA_vzAQ.zso", "https://www.zappos.com/running-shoes/CK_XARC81wEY0O4B4gIEMAECA4IDA-HyAQ.zso", "https://www.zappos.com/product/7165047/color/72", "https://www.zappos.com/null/4gIBMIIDA_LzAQ.zso", "https://www.zappos.com/product/7165047/color/17887", "https://www.zappos.com/product/7190382/color/3", "https://www.zappos.com/product/7182725/color/3", "https://www.zappos.com/product/102181/color/115", "https://www.zappos.com/men-sandals/CK_XARC51wHAAQLiAgMBAhg.zso", "https://www.zappos.com/product/101191/color/3", "https://www.zappos.com/hoka-women-shoes/CK_XAWIClxrAAQHiAgMBDBg.zso", "https://www.zappos.com/null/4gIBMIIDA_TzAQ.zso", "https://www.zappos.com/null/4gIBMIIDA-vzAQ.zso", "https://www.zappos.com/women-sandals/CK_XARC51wHAAQHiAgMBAhg.zso", "https://www.zappos.com/hoka-men-shoes/CK_XAWIClxrAAQLiAgMBDBg.zso", "https://www.zappos.com/on-men-shoes/CK_XAWICxh_AAQLiAgMBDBg.zso", "https://www.zappos.com/product/7158233/color/28", "https://www.zappos.com/shoes/CK_XAeICAjABggMDzfMB.zso", "https://www.zappos.com/shoes/CK_XAeICAjABggMD-vMB.zso", "https://www.zappos.com/product/101026/color/3", "https://www.zappos.com/null/4AEB4gIBHA.zso", "https://www.zappos.com/product/102179/color/3", "https://www.zappos.com/product/7212450/color/6" ], "start_min_date": null, "start_max_date": null, "results": [ [ { "ad_archive_id": "1856457768340957", "page_id": "7172307686", "snapshot": { "page_id": "7172307686", "page_profile_uri": "https://facebook.com/zappos", "page_name": "Zappos.com", "page_profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/605229556_1264083579073773_276540164055197950_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=e5KNf6wr9y0Q7kNvwERYJOq&_nc_oc=Adlg1aQ9JNq37HXi9taAUvrOnjmNuIkXxF-PjSyDNqAuY7SRN4u9C325vT9XKiZu71I&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfygILxqU2DARZex4ZagUSLz5lCp_AJw41e6vg0sROGYAg&oe=69B7CCF0", "body": { "text": "This season's must haves, only at Zappos. \ud83d\udc62" }, "caption": "zappos.com", "cards": [ { "body": "This season's must haves, only at Zappos. \ud83d\udc62", "caption": "zappos.com", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "Fast, FREE shipping on just-landed sneakers, boots, heels & more from your favorite brands. Now that's a win.", "link_url": "https://www.zappos.com/product/7165047/color/72", "original_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/603869031_834904779519512_2011076685899997798_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xxFE2xDErBEQ7kNvwEnnxq_&_nc_oc=Adks6s8JAN7HcjgRSt2mvvSJMDXd7qWdvOkWj03fX-ZX7_uK3DA49wez8w-ocehryRM&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfwpbThY9L_wORO2GZEx3KIE5gvJbnW7gvg_QG_o5RcGgQ&oe=69B7D13F", "resized_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/603869031_834904779519512_2011076685899997798_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xxFE2xDErBEQ7kNvwEnnxq_&_nc_oc=Adks6s8JAN7HcjgRSt2mvvSJMDXd7qWdvOkWj03fX-ZX7_uK3DA49wez8w-ocehryRM&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=V776smK2QZNFRXZ9H9kS6w&_nc_ss=8&oh=00_AfzrOqTwo6ly7XCDkYB6hOOJh-nu7n0AsmFTPPXJwpE6nQ&oe=69B7D13F", "watermarked_resized_image_url": "", "title": "Frye Campus 14L Cowboy Women's Boots Black Leather : 8 B - Medium", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_video_hd_url": null } ] } } ] ] } ``` ``` -------------------------------- ### Google Shopping API Response Example Source: https://docs.adyntel.com/ad-libraries/google-shopping The API returns an ID upon successful request, which is used to query the Google shopping status endpoint. ```json { "id": "12172142-7717-0066-0000-f1e50ca3d579" } ``` -------------------------------- ### POST /tiktok_search Source: https://docs.adyntel.com/ad-libraries/tiktok-search Execute a search for ads on TikTok using a keyword as the starting point. ```APIDOC ## POST api.adyntel.com/tiktok_search ### Description Execute a search for ads on TikTok using a keyword as the starting point. ### Method POST ### Endpoint api.adyntel.com/tiktok_search ### Parameters #### Request Body - **api_key** (string) - Required - Adyntel API key - **email** (string) - Required - Adyntel account email - **keyword** (string) - Required - Your search query - **country_code** (string) - Optional - Use if you want to limit the search to only one country ### Request Example { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "keyword": "toys", "country_code": "DE" } ``` -------------------------------- ### API Response for Domain Keywords Source: https://docs.adyntel.com/ad-libraries/paid-vs-organic-keywords The response object contains 'organic' and 'paid' data with absolute numbers, and 'organic_percentages' and 'paid_percentages' with calculated percentages. For example, `pos_1` from `organic_percentages` is derived from `pos_1` divided by `count` in the `organic` object. ```json { "organic": { "pos_1": 379, "pos_2_3": 1035, "pos_4_10": 3364, "pos_11_20": 4110, "pos_21_30": 4835, "pos_31_40": 4781, "pos_41_50": 3728, "pos_51_60": 2663, "pos_61_70": 2260, "pos_71_80": 2022, "pos_81_90": 1540, "pos_91_100": 1004, "count": 31721, "is_new": 11585, "is_up": 9083, "is_down": 8971, "is_lost": 0, "estimated_traffic": 371656 }, "organic_percentages": { "pos_1": 1.19, "pos_2_3": 3.26, "pos_4_10": 10.6, "pos_11_20": 12.96, "pos_21_30": 15.24, "pos_31_40": 15.07, "pos_41_50": 11.75, "pos_51_60": 8.4, "pos_61_70": 7.12, "pos_71_80": 6.37, "pos_81_90": 4.85, "pos_91_100": 3.17, "is_new": 36.52, "is_up": 28.63, "is_down": 28.28, "is_lost": 0.0 }, "paid": { "pos_1": 82, "pos_2_3": 11, "pos_4_10": 1, "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": 94, "is_new": 88, "is_up": 1, "is_down": 1, "is_lost": 0, "estimated_traffic": 8812, "estimated_ad_budget": 47297, "estimated_avg_cpc": 5.37 }, "paid_percentages": { "pos_1": 87.23, "pos_2_3": 11.7, "pos_4_10": 1.06, "pos_11_20": 0.0, "pos_21_30": 0.0, "pos_31_40": 0.0, "pos_41_50": 0.0, "pos_51_60": 0.0, "pos_61_70": 0.0, "pos_71_80": 0.0, "pos_81_90": 0.0, "pos_91_100": 0.0, "is_new": 93.62, "is_up": 1.06, "is_down": 1.06, "is_lost": 0.0 } } ``` -------------------------------- ### TikTok Search API Request Example Source: https://docs.adyntel.com/ad-libraries/tiktok-search Use this JSON payload to perform a TikTok ad search. Include your Adyntel API key, account email, and the desired search keyword. Optionally, specify a country code to filter results. ```json { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "keyword": "toys", "country_code": "DE" } ``` -------------------------------- ### List available commands Source: https://docs.adyntel.com/integrations/using-adyntel-in-slack Display all available commands for the Adyntel Slack bot. ```text /adyntel ``` -------------------------------- ### Verify MCP Connection Source: https://docs.adyntel.com/integrations/adyntel-mcp-server List configured MCP servers to ensure the Adyntel server is active. ```bash claude mcp list ``` -------------------------------- ### Manual Configuration for Claude Code Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Manually add the server definition to your ~/.claude.json configuration file. ```json { "mcpServers": { "adyntel-ads": { "type": "sse", "url": "https://mcp.adyntel.com/sse?email=YOUR_EMAIL&api_key=YOUR_API_KEY" } } } ``` -------------------------------- ### Configure Adyntel MCP for Claude Desktop and Cursor Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Add this JSON configuration to your Claude Desktop or Cursor settings to enable the Adyntel MCP server. ```json { "mcpServers": { "adyntel-ads": { "url": "https://mcp.adyntel.com/sse?email=YOUR_EMAIL&api_key=YOUR_API_KEY" } } } ``` -------------------------------- ### Add Adyntel MCP via Claude Code CLI Source: https://docs.adyntel.com/integrations/adyntel-mcp-server Use the CLI command to register the Adyntel MCP server with the specified transport. ```bash claude mcp add --transport sse adyntel-ads "https://mcp.adyntel.com/sse?email=YOUR_EMAIL&api_key=YOUR_API_KEY" ``` -------------------------------- ### POST api.adyntel.com/domain-keywords Source: https://docs.adyntel.com/ad-libraries/paid-vs-organic-keywords Retrieves an overview of paid and organic keywords for a specified domain, including budget and CPC estimations. ```APIDOC ## POST api.adyntel.com/domain-keywords ### Description This endpoint provides an overview of paid and organic keywords for a domain. Note that the company domain must be provided without prefixes like 'https://' or 'www.'. ### Method POST ### Endpoint api.adyntel.com/domain-keywords ### Parameters #### Request Body - **api_key** (string) - Required - Adyntel API key - **email** (number) - Required - Adyntel account email - **company_domain** (string) - Required - Company website (without www or http) ### Request Example { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "company_domain": "lokalise.com" } ### Response #### Success Response (200) - **organic** (object) - Absolute numbers for organic keyword rankings and traffic - **organic_percentages** (object) - Percentage distribution of organic keyword rankings - **paid** (object) - Absolute numbers for paid keyword rankings, traffic, budget, and CPC - **paid_percentages** (object) - Percentage distribution of paid keyword rankings #### Response Example { "organic": { "pos_1": 379, "pos_2_3": 1035, "pos_4_10": 3364, "count": 31721, "estimated_traffic": 371656 }, "paid": { "count": 94, "estimated_ad_budget": 47297, "estimated_avg_cpc": 5.37 } } ``` -------------------------------- ### POST /domain-keywords Source: https://docs.adyntel.com/openapi-docs/existing-endpoints Retrieves an overview of paid and organic keywords for a domain, including budget and CPC estimations. ```APIDOC ## POST /domain-keywords ### Description An overview of paid and organic keywords for a domain, with estimation of budgets and CPC included. ### Method POST ### Endpoint https://api.adyntel.com/domain-keywords ### Parameters #### Request Body - **email** (string) - Required - Adyntel account email - **api_key** (string) - Required - Adyntel API key - **company_domain** (string) - Required - Company website (without www or http) - **language** (string) - Optional - Language for keyword results (default: English) - **limit** (integer) - Optional - Number of results to return (default: 1) ### Request Example { "email": "user@example.com", "api_key": "your_api_key", "company_domain": "example.com" } ### Response #### Success Response (200) - **organic** (object) - Organic keyword statistics - **organic_percentages** (object) - Percentage distribution for organic metrics - **paid** (object) - Paid keyword statistics - **paid_percentages** (object) - Percentage distribution for paid metrics #### Response Example { "organic": { "count": 150, "estimated_traffic": 5000 }, "paid": { "count": 20, "estimated_ad_budget": 1000, "estimated_avg_cpc": 2.5 } } ``` -------------------------------- ### POST /google Source: https://docs.adyntel.com/ad-libraries/google Retrieves Google ads for a specified company domain. ```APIDOC ## POST api.adyntel.com/google ### Description See which Google ads a company is running by providing their website as input. Note that the company domain must be provided in 'company.com' format without prefixes like 'https://' or 'www.'. ### Method POST ### Endpoint api.adyntel.com/google ### Parameters #### Request Body - **api_key** (string) - Required - Adyntel API key - **email** (number) - Required - Adyntel account email - **company_domain** (string) - Required - Company website - **media_type** (string) - Optional - Filter results based on media type. Possible values: text, image, video. - **all_ads** (boolean) - Optional - Automatically scrape all pages. Requires a webhook_url. Warning: consumes credits per page. ### Request Example { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "company_domain": "clay.com" } ``` -------------------------------- ### POST API Request for Domain Keywords Source: https://docs.adyntel.com/ad-libraries/paid-vs-organic-keywords Use this JSON payload to send a POST request to the `api.adyntel.com/domain-keywords` endpoint. Ensure the `company_domain` is in the 'company.com' format, without prefixes. ```json { "api_key": "hd-nndgi7gy6b3kdsgd-a", "email": "elon@tesla.com", "company_domain": "lokalise.com" } ``` -------------------------------- ### KeywordsRequest Object Schema Source: https://docs.adyntel.com/openapi-docs/existing-endpoints Defines the structure for requesting keywords related to a company domain. Requires email, API key, and company domain. Optionally specify language and the number of results. ```json {"openapi":"3.0.3","info":{"title":"Adyntel API","version":"1.0.0"},"components":{"schemas":{"KeywordsRequest":{"type":"object","required":["email","api_key","company_domain"],"properties":{"email":{"type":"string","description":"Adyntel account email"},"api_key":{"type":"string","description":"Adyntel API key"},"company_domain":{"type":"string","description":"Company website (without www or http)"},"language":{"type":"string","default":"English","description":"Language for keyword results"},"limit":{"type":"integer","default":1,"description":"Number of results to return"}}}}}} ```