Trakkr

Get Account

Get the authenticated OpenAI Ads account. Use this first to verify that OPENAI_ADS_API_KEY works and to read account id, name, timezone, currency, and settings.

List Campaigns

List campaigns in the authenticated ad account with cursor pagination.

Get Campaign

Get one campaign by id.

List Ad Groups

List ad groups for a campaign.

Get Ad Group

Get one ad group by id.

List Ads

List ads in an ad group.

Get Ad

Get one ad by id, including review_status and creative metadata.

Get Insights

Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

List Audiences

List custom audiences for the authenticated ad account.

Get Audience

Get one custom audience by id.

Search Geo

Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

Manage Conversions

Manage conversion pixels, API keys, event settings, and conversion reporting.

Draft Context Hints

Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.