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.
Authentication
authentication 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"
}