AdnovaDocs
Ad Launcher

Export launch

Returns a finished Launch Batch as the rows of the Adnova dashboard's launched-batch CSV download: one row per Meta ad the batch launched or failed to launch, with the ad type, name and Meta ad id, ad set and campaign names, a shareable preview link, launch status, launch date, who launched it, the product set, the ad schedule, and the ad copy that went out. columns lists every column in dashboard order, as a label and the key each row uses, so a CSV built from them matches the dashboard download column for column. Missing values are -. For a partnership-code batch, the second column is Partnership Ad Code instead of Ad Creatives. Only a finished batch (completed, partially_completed or failed) can be exported; poll Get launch until then. Launch and schedule dates are formatted in the ad account's timezone, returned as timezone. Preview links are fetched from Meta at request time; if Meta cannot return them, those cells are - and the export still succeeds. Uses the **General** rate-limit bucket.

GET
/meta/launches/{batchId}/export

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

batchId*string
Length1 <= length

Query Parameters

adAccountId*string

Ad account this batch was launched against. Required so the per-ad-account access check can run; a batch launched against a different account returns 404.

Length1 <= length

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

application/json

curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/launches/string/export?adAccountId=string" \  -H "x-workspace-id: string" \  -H "x-org-id: string"
{
  "batchId": "01M2NB0JWDM6P5E9VWKH1AGAG8",
  "status": "completed",
  "timezone": "Asia/Kolkata",
  "columns": [
    {
      "label": "Ad Preview Link",
      "key": "adPreviewLink"
    }
  ],
  "rows": [
    {
      "sno": 1,
      "creatives": "earth-pot.jpg",
      "partnershipAdCode": "string",
      "adType": "Single Image",
      "adName": "earth-pot",
      "adId": "120251587580270030",
      "adset": "Traffic",
      "campaign": "Spring Sale",
      "adPreviewLink": "https://fb.me/2cJCmZCsY7RlYHq",
      "status": "Launched",
      "launchedAt": "Sep 16, 2026",
      "launchedBy": "Alex",
      "productSetId": "-",
      "scheduleStartDate": "Sep 17, 2026 05:30 am",
      "scheduleEndDate": "Oct 1, 2026 05:29 am",
      "defaultPrimaryText": "string",
      "primaryTextVariation1": "string",
      "primaryTextVariation2": "string",
      "primaryTextVariation3": "string",
      "primaryTextVariation4": "string",
      "defaultHeadline": "string",
      "headlineVariation1": "string",
      "headlineVariation2": "string",
      "headlineVariation3": "string",
      "headlineVariation4": "string",
      "adDescription": "string",
      "descriptionVariation1": "string",
      "descriptionVariation2": "string",
      "descriptionVariation3": "string",
      "descriptionVariation4": "string",
      "cta": "LEARN_MORE",
      "webLink": "https://example.com",
      "phoneNumber": "string",
      "displayLink": "string",
      "utm": "utm_source=meta&utm_campaign=spring"
    }
  ]
}
{
  "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"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}