WakeCreative 素材搜索 API

使用关键词和筛选条件检索结构化素材，响应统一采用 WakeCreative 的 data + metadata 包装。

GET /v1/wakecreative/materials 试用

WakeCreative 素材搜索 API
GET /v1/wakecreative/materials

使用关键词和筛选条件检索结构化素材，响应统一采用 WakeCreative 的 data + metadata 包装。

鉴权：x-api-key
示例 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

参数：
- query (query · string · 可选) = UGC skincare
- cursor (query · string · 可选)
- limit (query · integer · 可选) = 20
- order (query · string · 可选) = relevance
- language (query · string · 可选) = en
- style_tags (query · array · 可选) = ugc, testimonial
- cta_type_tags (query · array · 可选) = shop_now

概览

使用关键词、排序和筛选条件检索素材列表，适合构建创意搜索与发现体验。

你可以组合关键词、排序和可重复筛选字段来查找可复用素材，再通过素材详情接口继续下钻。

调用时同样需要通过 x-api-key 请求头完成鉴权。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

query string

关键词查询。

示例：

UGC skincare

cursor string

前一个请求返回的分页游标。

limit integer

结果大小，从 1 到 100。

示例：

order string

排序顺序。

示例：

relevance

枚举： relevance, latest, oldest

language string

按语言过滤。

示例：

style_tags array

可重复样式标签过滤器。

示例：

ugc, testimonial

cta_type_tags array

可重复的 CTA 型过滤器。

示例：

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