AdnovaDocs
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).

GET
/meta/ad-accounts/{adAccountId}/adsets

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
Length1 <= length

Query 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.

Length1 <= length
x-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.

Length1 <= length

Response 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"
}