fly0pants 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
| Parameter | Type | Default | Description |
|---|---|---|---|
| keyword | string | "" | Search keyword: app name, ad copy, advertiser, product, or category |
| creative_team | string[] | omit | Creative type codes, e.g. ["010"] for video |
| country_ids | string[] | omit | Country codes, e.g. ["US","JP"] |
| start_date | string | API default | Start date, YYYY-MM-DD |
| end_date | string | API default | End date, YYYY-MM-DD |
| sort_field | string | "3" |
"3" first seen, "4" days active, "11" relevance, "15" impressions |
| sort_rule | string | "desc" |
"desc" or "asc" |
| page | int | 1 |
Page number, starting from 1 |
| page_size | int | 20 |
Results per page, 1-60 |
| trade_level1 | string[] | omit | Industry category IDs |
| content_type | string | "creative" |
Fixed request value |
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://..."}
]
}