API referenceAd Accounts

Get asset and targeting options

Lists the selectable assets and targeting values on the ad account for optionType (pixels, facebookPages, instagramAccounts, audiences, interests, locations or conversionEvents), optionally filtered by query.

GET
/v1/brands/{brandId}/ad-accounts/{accountId}/options
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

accountId*string

The ad account id (act_… on Meta, biz_… on Whop).

optionType*string

Type of option: pixels, facebookPages, instagramAccounts, audiences, interests, locations, conversionEvents

query?string

Search query to filter results

Response Body

Get asset and targeting options

application/json
  1. response
[key: string]?unknown
curl -X GET "https://example.com/v1/brands/0/ad-accounts/string/options?optionType=string" \  -H "Authorization: Bearer koast_sk_..."
{  "property1": null,  "property2": null}

Required scope: read. CLI: koast get-available-options, see Ad Accounts commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.