AdnovaDocs
Analytics

Fetch ad transcripts

Returns the spoken script of the video creatives behind a batch of ads — what the ad actually says. Take the adIds from an insights response. Read-only. Adnova transcribes video creatives in the app; this endpoint returns transcripts that already exist and never starts a new one. An ad with no transcript comes back with an empty transcripts array and a reason — not_found, no_video, or no_transcript. Every ad you ask for is present in the response, so you never have to diff it against your request. Most ads yield a single transcript, because most creatives hold one video — a creative with several videos yields one transcript per transcribed video, in the order the creative lists them. At most 50 ad ids per request.

POST
/transcripts

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/analytics/v1/transcripts" \  -H "Content-Type: application/json" \  -d '{    "platform": "facebook",    "adAccountId": "string",    "workspaceId": "string",    "adIds": [      "string"    ]  }'
{
  "platform": "facebook",
  "adAccountId": "01JAN78QQ6BX9ZPKA6A8JWA6G1",
  "transcripts": [
    {
      "adId": "100000000000000001",
      "transcripts": [
        {
          "text": "Sample transcript line one. Sample transcript line two.",
          "segments": [
            {
              "start": 0,
              "end": 1.8,
              "text": "Sample transcript line one."
            },
            {
              "start": 1.8,
              "end": 3.4,
              "text": "Sample transcript line two."
            }
          ]
        }
      ]
    },
    {
      "adId": "100000000000000002",
      "transcripts": [],
      "reason": "no_video"
    },
    {
      "adId": "100000000000000003",
      "transcripts": [],
      "reason": "not_found"
    }
  ]
}
{
  "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"
}