AdMapix Raw Data Search

Use this skill to fetch raw competitor ad creative data from AdMapix.

Return structured data from the API. Presentation, message-send, autonomous research, summary, insight, recommendation, and dashboard workflows are out of scope.

Data Source

Prefer the admapix.search_creatives MCP tool when it is available. If no MCP tool is available, call the API directly:

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

Never print or expose the API key.

Request Parameters

Do not add presentation-generation or message-send fields to the request body.

Parameter Parsing

Extract all parameters the user provides. Read references/param-mappings.md when natural-language mapping is needed for:

• creative type: video/image/playable, 视频/图片/试玩
• region or country: Southeast Asia, 美国, 日韩, Europe
• relative date ranges: last week, 最近一周, last month
• sorting: newest, most impressions, longest running
• page size and pagination

If the user did not provide a keyword or an equivalent searchable target, ask one concise question for the keyword. Other parameters can use defaults.

Output Rules

Return raw structured JSON only. Keep the API field names when possible.

Required response shape after a successful call:

{
  "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": []
}

For errors, return structured JSON:

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

Do not:

• hide the records behind external presentation links
• hide the records behind a link
• summarize the result list
• rank, analyze, or recommend strategy unless the user separately asks for analysis after receiving data
• run multi-step autonomous workflows or external search
• format the response as a landing page, card, table-first document, or dashboard

Raw Response Fields

Each item in list may include upstream fields such as:

{
  "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://..."}
  ]
}