Ad Launcher
List catalogs (with product sets)
Catalogs under a business, each with its product sets inline (product_sets[]). This is where you get a product_set_id for catalog / collection / dynamic-product launches. Cached for 24h — pass refetch=true to fetch fresh from Meta.
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 <= lengthbusinessId*string
Length
1 <= lengthQuery Parameters
refetch?string
Value in
"true" | "false"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/businesses/string/catalogs" \ -H "x-workspace-id: string" \ -H "x-org-id: string"{
"data": [
{
"catalog_id": "456789012345",
"name": "Acme Product Catalog",
"product_sets": [
{
"product_set_id": "678901234567",
"name": "Spring Sale"
}
]
}
]
}{
"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"
}