Ads

Ad performance insights

get/api/v1/ads/insights

Request

  • Base URL
    https://app.tryadeli.com
  • Auth
    HTTP bearer

Query parameters

accountIdstring uuid

The Meta Ads (meta_ads), TikTok Ads (tiktok_ads) or LinkedIn Ads (linkedin_ads) account. It names its profile and network, so profileId and platform can be left out. A Facebook Pages, organic TikTok or organic LinkedIn account id is not accepted.

profileIdstring uuid

The profile whose ads account to use, when no accountId is given.

platform'meta_ads' | 'tiktok_ads' | 'linkedin_ads'

Needed only when the profile has more than one ad network connected and no accountId is given.

adAccountIdstring required
objectIdstring

A campaign, ad set (ad group), or ad id.

level'campaign' | 'ad_group' | 'ad'

TikTok and LinkedIn: the level of objectId. Defaults to campaign (a LinkedIn campaign group).

'age' | 'gender' | 'country_code' | 'platform'
OR
'job_function' | 'seniority' | 'industry' | 'company_size' | 'country_code'

TikTok (age, gender, country_code, platform) or LinkedIn (job_function, seniority, industry, company_size, country_code): return an audience breakdown (rows) instead of the daily series (points). LinkedIn rows carry a label and the response delayed: true.

sincestring
untilstring

Response

Success

OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.