admapix

AdMapix 原始数据搜索

使用此技能从 AdMapix 获取原始竞品广告创意数据。

返回 API 提供的结构化数据。展示、发送消息、自主研究、摘要、洞察、建议和仪表板工作流均不在此范围内。

数据源

如果 admapix.search_creatives MCP 工具可用，请优先使用。如果没有可用的 MCP 工具，请直接调用 API：

curl -s -X POST "https://api.admapix.com/api/data/search" \
  -H "X-API-Key: $ADMAPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"creative","keyword":"puzzle game","page":1,"page_size":20,"sort_field":"3","sort_rule":"desc"}'

切勿打印或暴露 API 密钥。

请求参数

参数	类型	默认值	说明
keyword	string	""	搜索关键词：应用名称、广告文案、广告主、产品或类别
creative_team	string[]	omit	创意类型代码，例如视频对应的 ["010"]
country_ids	string[]	omit	国家代码，例如 ["US","JP"]
start_date	string	API default	开始日期，格式为 YYYY-MM-DD
end_date	string	API default	结束日期，格式为 YYYY-MM-DD
sort_field	string	"3"	"3" 首次展示时间，"4" 活跃天数，"11" 相关性，"15" 展示次数
sort_rule	string	"desc"	"desc" 或 "asc"
page	int	1	页码，从 1 开始
page_size	int	20	每页结果数，范围为 1-60
trade_level1	string[]	omit	行业类别 ID
content_type	string	"creative"	固定请求值

不要在请求正文中添加用于生成展示内容或发送消息的字段。

参数解析

提取用户提供的所有参数。如需将自然语言映射为参数，请阅读 references/param-mappings.md，适用情况包括：

• 创意类型：视频/图片/试玩、video/image/playable
• 地区或国家：东南亚、美国、日韩、欧洲
• 相对日期范围：上周、最近一周、上个月
• 排序方式：最新、展示次数最多、投放时间最长
• 每页结果数和分页

如果用户未提供关键词或等效的可搜索目标，请用一个简短问题询问关键词。其他参数可使用默认值。

输出规则

仅返回原始结构化 JSON。尽可能保留 API 字段名称。

成功调用后的必需响应格式：

{
  "request": {
    "content_type": "creative",
    "keyword": "puzzle game",
    "page": 1,
    "page_size": 20,
    "sort_field": "3",
    "sort_rule": "desc"
  },
  "totalSize": 1234,
  "page": 1,
  "page_size": 20,
  "list": []
}

发生错误时，返回结构化 JSON：

{
  "error": {
    "code": "missing_api_key",
    "message": "Missing ADMAPIX_API_KEY environment variable",
    "retry": false
  }
}

请勿：

• 将记录隐藏在外部展示链接后
• 将记录隐藏在链接后
• 总结结果列表
• 对结果进行排名、分析或推荐策略，除非用户在收到数据后另行要求分析
• 运行多步骤自主工作流或外部搜索
• 将响应格式化为落地页、卡片、以表格为主的文档或仪表板

原始响应字段

list 中的每个项目可能包含上游字段，例如：

{
  "id": "creative-id",
  "title": "App or advertiser name",
  "describe": "Ad copy",
  "imageUrl": ["https://..."],
  "videoUrl": ["https://..."],
  "playHtmlUrl": ["https://..."],
  "globalFirstTime": "2026-03-08 12:00:00",
  "globalLastTime": "2026-03-10 12:00:00",
  "findCntSum": 3,
  "impression": 123456,
  "showCnt": 5,
  "adSource": "network",
  "appList": [
    {"name": "App", "pkg": "com.example.app", "logo": "https://..."}
  ]
}