API referenceLaunches

Get targeting options

Searches the targeting options available to the launch (locations, interests, demographics, behaviors and audiences) by query, returning the ad platform ids and types to use in targeting settings.

GET
/v1/brands/{brandId}/launches/{launchId}/targeting-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.

launchId*string

The campaign launch (batch) id.

query?string

Search query to filter targeting options

Response Body

Get targeting options

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

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