# Adyntel

Adyntel provides an API to retrieve LinkedIn ads for a given company using the company's domain or LinkedIn Page ID.

- **Category:** ads & conversion
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `ADYNTEL`
- **Version:** 20260316_00

## Tools

### Get Google Ads By Company

**Slug:** `ADYNTEL_GET_GOOGLE_ADS_BY_COMPANY`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_type` | string ("text" | "image" | "video") | No | Filter results by content type. |
| `company_domain` | string | Yes | Company website domain in 'company.com' format (no https:// or www. prefix). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Google Shopping Search Status

**Slug:** `ADYNTEL_GET_GOOGLE_SHOPPING_SEARCH_STATUS`

Check 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The job identifier received from the initial google_shopping endpoint response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get LinkedIn Ads By Company

**Slug:** `ADYNTEL_GET_LINKED_IN_ADS_BY_COMPANY`

Retrieve LinkedIn ads for a company by domain or LinkedIn page ID. Returns ad creatives and campaign details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_domain` | string | No | Company website domain in 'company.com' format (no https:// or www. prefix). Either company_domain or linkedin_page_id is required. |
| `linkedin_page_id` | integer | No | LinkedIn Page numeric identifier. Either company_domain or linkedin_page_id is required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Meta Ads By Company Or Page

**Slug:** `ADYNTEL_GET_META_ADS_BY_COMPANY_OR_PAGE`

Retrieve Meta/Facebook ads for a company domain or Facebook page URL. Returns ad creatives, engagement metrics, and campaign details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_type` | string ("image" | "meme" | "image_and_meme" | "video") | No | Filter results by specific media format. |
| `webhook_url` | string | No | Endpoint URL to receive returned data via webhook. |
| `country_code` | string | No | Filter results to a specific country using two-letter ISO country code (e.g., US, GB, FR). |
| `facebook_url` | string | No | Facebook page URL. Must start with https://. Either facebook_url or company_domain is required. |
| `active_status` | string ("inactive" | "all") | No | Filter by ad campaign status. Defaults to active ads only. |
| `company_domain` | string | No | Company website domain in 'company.com' format (no https:// or www. prefix). Either facebook_url or company_domain is required. |
| `continuation_token` | string | No | Token for pagination to retrieve additional ad sets. Obtained from the initial response if more ads exist. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Paid Vs Organic Keywords

**Slug:** `ADYNTEL_GET_PAID_VS_ORGANIC_KEYWORDS`

Analyze paid vs organic keyword performance for a company domain. Returns keyword data comparing paid advertising and organic search performance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_domain` | string | Yes | Company website domain in 'company.com' format (no https:// or www. prefix). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Meta Ads

**Slug:** `ADYNTEL_META_AD_SEARCH`

Search the Meta ad library.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keyword` | string | Yes | The keyword you want to use in your search. |
| `country_code` | string | No | To limit results to one specific country. Please use ISO 3166-1 alpha-2 country code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search TikTok Ads By Keyword

**Slug:** `ADYNTEL_SEARCH_TIK_TOK_ADS_BY_KEYWORD`

Search the TikTok ad library using keywords. Returns matching ads with creative content, engagement metrics, and targeting information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keyword` | string | Yes | The search query to find TikTok ads. |
| `country_code` | string ("AT" | "BE" | "BG" | "CH" | "CY" | "CZ" | "DE" | "DK" | "EE" | "ES" | "FI" | "FR" | "GB" | "GR" | "HR" | "HU" | "IE" | "IS" | "IT" | "LI" | "LT" | "LU" | "LV" | "MT" | "NL" | "NO" | "PL" | "PT" | "RO" | "SE" | "SI" | "SK" | "ALL") | No | Filter search results to a specific country. Omitting returns global results. Note: US filtering is not currently supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Google Shopping Search

**Slug:** `ADYNTEL_START_GOOGLE_SHOPPING_SEARCH`

Start 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_domain` | string | Yes | Company website domain in 'company.com' format (no https:// or www. prefix). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |