WakeCreative Materials Search API

Search structured creative materials with keyword and filters. Responses always use the WakeCreative data + metadata envelope.

Open Playground

GET /v1/wakecreative/materials Try it

WakeCreative Materials Search API
GET /v1/wakecreative/materials

Search structured creative materials with keyword and filters. Responses always use the WakeCreative data + metadata envelope.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/wakecreative/materials?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now

Parameters:
- query (query · string · optional) = UGC skincare
- cursor (query · string · optional)
- limit (query · integer · optional) = 20
- order (query · string · optional) = relevance
- language (query · string · optional) = en
- style_tags (query · array · optional) = ugc, testimonial
- cta_type_tags (query · array · optional) = shop_now

Overview

Search materials using keywords, sorting, and filters for creative discovery workflows.

Use keyword, order, and repeatable filter fields to find reusable ad creatives, then drill into details with the material detail endpoint.

This endpoint also requires the x-api-key request header.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

query string

Keyword query.

Example:

UGC skincare

cursor string

Pagination cursor returned by the previous request.

limit integer

Result size, from 1 to 100.

Example:

order string

Sort order.

Example:

relevance

enum: relevance, latest, oldest

language string

Filter by language.

Example:

style_tags array

Repeatable style tags filter.

Example:

ugc, testimonial

cta_type_tags array

Repeatable CTA type filter.

Example:

shop_now


              curl 'https://api.datawake.ai/v1/wakecreative/materials?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/wakecreative/materials?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now", {
  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?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now",
    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?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now",
    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?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now", 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?query=UGC+skincare&limit=20&order=relevance&language=en&style_tags=ugc&style_tags=testimonial&cta_type_tags=shop_now"))
    .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.",
      "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"
      ],
      "match_reasons": [
        "keyword: skincare",
        "style_tags: ugc"
      ]
    }
  ],
  "metadata": {
    "success": true,
    "count": 1,
    "next_cursor": null,
    "request_id": "req_demo_materials",
    "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."
  }
}