⌘K

Console Playground

WakeCreative Material Detail API

Fetch a single material with structured tags, ad context, and envelope metadata.

Open Playground

GET /v1/wakecreative/materials/{material_id} Try it

WakeCreative Material Detail API
GET /v1/wakecreative/materials/{material_id}

Fetch a single material with structured tags, ad context, and envelope metadata.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8

Parameters:
- material_id (path · string · required) = video:AQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8

Overview

Returns the detailed view for a single material, including structured fields, labels, and related context.

Use it after search when you need richer script, CTA, and latest ad context for a single creative.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Path Parameters

material_id string required

Material identifier returned by the list endpoint.

Example:

video:AQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8

Query Parameters

This endpoint has no query parameters.


              curl 'https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

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


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

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

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/wakecreative/materials/video%3AAQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "data": {
    "material_id": "video:AQPH9mGfsj1Ar0NeTFHORRWxRkb-LjrcDiWdrY-Zom5YGQZjOpQI63I3AUYVqNANO1LhSY9wyTVbbacmIeYKOHqFiYkW_D6RChZLeb8",
    "summary_short": "Fast paced skincare UGC with before/after framing.",
    "summary_long": "A creator-style skincare explainer that opens with a hook, shows the product texture, and closes on a direct purchase CTA.",
    "representative_brand": "GlowLab",
    "source_ad_count": 18,
    "language": "en",
    "duration_seconds": 28,
    "aspect_ratio": "9:16",
    "preview_image_url": "https://cdn.datawake.ai/examples/mat_ugc_001.jpg",
    "video_url": "https://cdn.datawake.ai/examples/mat_ugc_001.mp4",
    "first_seen_at": "2026-03-01T00:00:00Z",
    "last_seen_at": "2026-04-14T00:00:00Z",
    "core_tags": [
      "ugc",
      "skincare",
      "testimonial"
    ],
    "style_tags": [
      "ugc",
      "close_up"
    ],
    "ad_angle_tags": [
      "problem_solution"
    ],
    "script_structure_tags": [
      "hook",
      "demo",
      "cta"
    ],
    "cta_type_tags": [
      "shop_now"
    ],
    "landing_page_domains": [
      "glowlab.com"
    ],
    "latest_ads": [
      {
        "ad_archive_id": "ad_10001",
        "title": "Glass skin in 7 days",
        "body": "Watch the texture reveal.",
        "cta_text": "Shop now"
      }
    ],
    "matched_ads": [
      {
        "ad_archive_id": "ad_10002",
        "title": "Night routine",
        "body": "UGC testimonial with demo.",
        "cta_text": "Learn more"
      }
    ]
  },
  "metadata": {
    "success": true,
    "count": 1,
    "next_cursor": null,
    "request_id": "req_demo_material_detail",
    "query_mode": "keyword",
    "executed_mode": "keyword"
  }
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "server_error",
    "message": "The service could not complete this request."
  }
}