Ad Launcher
List adsets
Returns adsets under the ad account, with campaign metadata. Cached for 24h — pass refetch=true to fetch fresh from Meta. Pass ?q= to filter by adset name (case-insensitive substring).
Authentication
authentication api-key<token>
Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.
In: header
Path Parameters
adAccountId*string
Length
1 <= lengthQuery Parameters
refetch?string
When true, bypass the local cache.
Value in
"true" | "false"q?string
Case-insensitive substring match against the adset name.
Header Parameters
x-workspace-id*string
Workspace the request operates in. Get it from List workspaces.
Length
1 <= lengthx-org-id*string
Organization context (required on every endpoint). For lookup endpoints the org is derived from the ad account in the URL, so any org id you have access to is accepted.
Length
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/ad-accounts/string/adsets?q=carousel" \ -H "x-workspace-id: string" \ -H "x-org-id: string"{
"data": [
{
"id": "string",
"name": "string",
"status": "string",
"campaign_id": "string",
"campaign": {
"id": "string",
"name": "string",
"status": "string",
"objective": "string"
}
}
]
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}