NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Adyntel connects to a Nagent workspace with an API key. Once it is connected, agents can call 8 Adyntel actions, such as "Get Google Ads By Company", "Get Google Shopping Search Status" and "Get LinkedIn Ads By Company". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Adyntel, with input parameters and output schema.
ADYNTEL_GET_GOOGLE_ADS_BY_COMPANYRetrieve Google ads for a company domain. Returns ad creatives including text, image, and video ads with advertiser information. Response includes a `total_ad_count` field that typically exceeds the count of ads in the returned `ads` array — a single call returns only a partial slice of all available ads.
Input parameters
Filter results by content type.
Company website domain in 'company.com' format (no https:// or www. prefix).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_GET_GOOGLE_SHOPPING_SEARCH_STATUSCheck the status and retrieve results of a Google Shopping ads search. Use the ID returned from the google_shopping endpoint. No credits charged for status checks.
Input parameters
The job identifier received from the initial google_shopping endpoint response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_GET_LINKED_IN_ADS_BY_COMPANYRetrieve LinkedIn ads for a company by domain or LinkedIn page ID. Returns ad creatives and campaign details.
Input parameters
Company website domain in 'company.com' format (no https:// or www. prefix). Either company_domain or linkedin_page_id is required.
LinkedIn Page numeric identifier. Either company_domain or linkedin_page_id is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_GET_META_ADS_BY_COMPANY_OR_PAGERetrieve Meta/Facebook ads for a company domain or Facebook page URL. Returns ad creatives, engagement metrics, and campaign details.
Input parameters
Filter results by specific media format.
Endpoint URL to receive returned data via webhook.
Filter results to a specific country using two-letter ISO country code (e.g., US, GB, FR).
Facebook page URL. Must start with https://. Either facebook_url or company_domain is required.
Filter by ad campaign status. Defaults to active ads only.
Company website domain in 'company.com' format (no https:// or www. prefix). Either facebook_url or company_domain is required.
Token for pagination to retrieve additional ad sets. Obtained from the initial response if more ads exist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_GET_PAID_VS_ORGANIC_KEYWORDSAnalyze paid vs organic keyword performance for a company domain. Returns keyword data comparing paid advertising and organic search performance.
Input parameters
Company website domain in 'company.com' format (no https:// or www. prefix).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_META_AD_SEARCHSearch the Meta ad library.
Input parameters
The keyword you want to use in your search.
To limit results to one specific country. Please use ISO 3166-1 alpha-2 country code.
Token for pagination to retrieve additional results. Obtained from the response's continuation_token field when is_result_complete is false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_SEARCH_TIK_TOK_ADS_BY_KEYWORDSearch the TikTok ad library using keywords. Returns matching ads with creative content, engagement metrics, and targeting information.
Input parameters
The search query to find TikTok ads.
Filter search results to a specific country. Omitting returns global results. Note: US filtering is not currently supported.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ADYNTEL_START_GOOGLE_SHOPPING_SEARCHStart an asynchronous Google Shopping ads search for a company domain. Returns a job ID to check status with the google_shopping_status endpoint.
Input parameters
Company website domain in 'company.com' format (no https:// or www. prefix).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 8 Adyntel actions on Nagent, including "Get Google Ads By Company", "Get Google Shopping Search Status" and "Get LinkedIn Ads By Company". Get Google Ads By Company: Retrieve Google ads for a company domain. Each action is listed on this page with its input parameters and its output.
Adyntel connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Google Ads By Company takes 1 required input: company_domain. It also takes 1 optional input: media_type. It returns data, error and successful.