Get a creative

One ad with its full creative, analysis, transcript and signed media URLs.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/creatives/example_string?location_id=example_string&include=raw" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://mythic-analytics.gulp.workers.dev/client/v1/creatives/example_string?location_id=example_string&include=raw"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://mythic-analytics.gulp.workers.dev/client/v1/creatives/example_string?location_id=example_string&include=raw", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://mythic-analytics.gulp.workers.dev/client/v1/creatives/example_string?location_id=example_string&include=raw", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://mythic-analytics.gulp.workers.dev/client/v1/creatives/example_string?location_id=example_string&include=raw')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "ad_id": "example_string",
    "account_id": "example_string",
    "campaign_id": "example_string",
    "adset_id": "example_string",
    "ad_name": "John Doe",
    "adset_name": "John Doe",
    "campaign_name": "John Doe",
    "effective_status": "ACTIVE",
    "gone": true,
    "gone_at": "2024-12-25T10:00:00Z",
    "ad_created_at": "2024-12-25T10:00:00Z",
    "creative_id": "example_string",
    "creative_found": true,
    "display_format": "image",
    "title": "example_string",
    "body": "example_string",
    "link_description": "example_string",
    "cta_type": "LEARN_MORE",
    "cta_text": "Learn More",
    "link_url": "example_string",
    "has_video": true,
    "video_id": "example_string",
    "video_duration_s": 3.14,
    "spend_90d": 3.14,
    "impressions_90d": 42,
    "last_spend_date": "2024-12-25",
    "spend_30d": 3.14,
    "impressions_30d": 42,
    "media_status": "pending",
    "analysis_status": "pending",
    "hook": "example_string",
    "hook_start_s": 3.14,
    "hook_end_s": 3.14,
    "tags": {},
    "epic": {
      "all_stages_in_order": true,
      "rules_met": 42,
      "rules_total": 42
    },
    "thumbnail_url": "example_string",
    "first_seen_at": "2024-12-25T10:00:00Z",
    "last_seen_at": "2024-12-25T10:00:00Z",
    "carousel_cards": [
      {}
    ],
    "asset_feed": {},
    "media": [
      {
        "slot": "image:0",
        "kind": "image",
        "quality": "hd",
        "width": 123,
        "height": 42,
        "copied_at": "2024-12-25T10:00:00Z",
        "last_error": "example_string",
        "key": "example_string",
        "bytes": 42,
        "content_type": "example_string",
        "url": "example_string",
        "skipped": "example_string",
        "error": "example_string"
      }
    ],
    "analysis": {},
    "analysis_model": "example_string",
    "analysis_input_tokens": 42,
    "analysis_cost_usd": 3.14,
    "analyzed_at": "2024-12-25T10:00:00Z",
    "transcript": {
      "status": "example_string",
      "text": "example_string",
      "sentences": [
        {
          "start": 3.14,
          "end": 3.14,
          "text": "example_string"
        }
      ],
      "duration_s": 3.14,
      "language": "example_string",
      "error": "example_string",
      "completed_at": "2024-12-25T10:00:00Z"
    },
    "spend_error": "example_string",
    "raw": {}
  }
}

{
  "error": "Error",
  "message": "Error. The code names the cause, e.g. `feature_not_in_plan`, `agency_required`, `not_found`, `sync_throttled`, `sync_in_progress`, `no_meta_source`, `pipeline_disabled`.",
  "code": 402
}

GET

/client/v1/creatives/{ad_id}

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Agency key (ak_), location secret key (sk_, reads only) or a scoped mcp_ key with creative_analysis:read or creative_analysis:write. See Using an mcp_ key over HTTP.

path

ad_idstring

Required

The Meta ad id.

Pattern: ^[0-9]+$

query

location_idstring

Location to scope to. Required for ak_ keys or send X-Location-Id. Ignored for sk_.

query

includestring

raw: also return the stored source row (bounded).

Options: raw

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. Agency key (ak_), location secret key (sk_, reads only) or a scoped mcp_ key with creative_analysis:read or creative_analysis:write. See Using an mcp_ key over HTTP.