LeoYeAI/agent-master-skills / skills/admapix-ice
admapix
VerifiedAd intelligence & app analytics assistant. Search ad creatives, analyze apps, view rankings, track downloads/revenue, and get market insights via api.admapix.com. Triggers: 找素材, 搜广告, 广告素材, 竞品分析, 广告分析, 排行榜, 下载量, 收入分析, 市场分析, 投放分析, App分析, 出海分析, search ads, find creatives, ad spy, ad analysis, app ranking, download data, revenue, market analysis, app intelligence, competitor analysis, ad distribution.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.2 KB |
| README_CN.md | markdown | 2.2 KB |
| SKILL.md | skill md | 18.1 KB |
| _meta.json | config | 275 B |
| references/api-creative.md | markdown | 11.5 KB |
| references/api-distribution.md | markdown | 4.2 KB |
| references/api-download-revenue.md | markdown | 4.0 KB |
| references/api-market.md | markdown | 5.9 KB |
| references/api-product.md | markdown | 11.6 KB |
| references/api-ranking.md | markdown | 6.8 KB |
| references/param-mappings.md | markdown | 4.6 KB |
references/api-distribution.md
View on GitHub# App Distribution API / 应用投放分布接口
Base URL: `https://api.admapix.com`
Auth: `X-API-Key: $ADMAPIX_API_KEY`
> These endpoints require a `unified_product_id`. Get it from `unified-product-search` first.
---
## 1. App Distribution — 应用推广分布
`POST /api/data/app-distribution`
Analyze an app's ad distribution across different dimensions.
### Request Body
```json
{
"unified_product_id": "xxx",
"dim": "country",
"start_time": "",
"end_time": "",
"countries": [],
"media_ids": [],
"material_type": "",
"index_type": 0
}
```
| Parameter | Type | Default | Description |
|---|---|---|---|
| unified_product_id | string | required | Target app ID |
| dim | string | required | Distribution dimension (see below) |
| start_time | string | 30 days ago | YYYY-MM-DD |
| end_time | string | today | YYYY-MM-DD |
| countries | string[] | [] | Country filter |
| media_ids | string[] | [] | Media channel filter |
| material_type | string/int | "" | Material type filter |
| index_type | int | 0 | Index type selector |
### Dimensions
| dim | Description | Returns |
|---|---|---|
| `trend` | 投放趋势 | Time series of ad volume over time |
| `country` | 投放国家分布 | Per-country ad placement distribution |
| `media` | 投放媒体位分布 | Distribution across publisher apps/placements where ads are displayed. **Note:** This returns the specific apps where ads appear (e.g. "Block Blast", "Snake.io", "Solitaire"), NOT ad network names like Facebook/Google. These are the traffic sources/publisher apps carrying the ads. Present them as "投放媒体位" or "广告展示位". |
| `platform` | 平台分布 | iOS vs Android breakdown |
| `type` | 素材类型分布 | Image vs video vs playable distribution |
| `image` | 图片尺寸分布 | Image size/aspect ratio breakdown |
| `video` | 视频时长分布 | Video duration breakdown |
| `lang` | 语言分布 | Ad language distribution |
### Response Examples
**dim=country:**
```json
{
"list": [
{"code": "US", "name": "United States", "cnt": 500, "ratio": 0.35},
{"code": "JP", "name": "Japan", "cnt": 300, "ratio": 0.21}
]
}
```
**dim=trend:**
```json
{
"list": [
{"date": "2026-03-01", "cnt": 50},
{"date": "2026-03-02", "cnt": 65}
]
}
```
**dim=media (publisher apps / ad placements):**
```json
{
"list": [
{"id": "101", "name": "Block Blast Adventure Master", "cnt": 400, "ratio": 0.15},
{"id": "102", "name": "Snake.io", "cnt": 250, "ratio": 0.09},
{"id": "103", "name": "Solitaire", "cnt": 180, "ratio": 0.07}
]
}
```
These are the apps where the target app's ads are being shown (publisher side). When presenting this data, you can categorize them (e.g. casual games, tools, content apps) to provide more actionable insights.
---
## 2. Distribute Dims — 素材分布维度
`GET /api/data/distribute-dims`
Returns which distribute dimensions are available per content type. This is for the creative-level distribute endpoint (`/api/data/distribute`), not for app-distribution.
### Response
```json
{
"creative": ["media", "adfaction", "app"],
"imagevideo": ["media", "adfaction", "app", "country"],
"preplay": ["media", "adfaction", "app"],
"demoad": ["media", "adfaction", "app"],
"document": ["media", "adfaction", "app"]
}
```
---
## Common Workflows / 常用工作流
### "Temu 主要在哪些国家投广告?"
```
app-distribution(unified_product_id=id, dim="country")
```
### "Temu 用了哪些广告渠道?"
```
app-distribution(unified_product_id=id, dim="media")
```
### "Temu 的投放趋势怎么样?"
```
app-distribution(unified_product_id=id, dim="trend", start_time="2026-01-01", end_time="2026-03-16")
```
### "Temu 在美国投了多少视频广告 vs 图片广告?"
```
app-distribution(unified_product_id=id, dim="type", countries=["US"])
```
### Full app advertising profile (multi-call)
1. `dim="country"` → where they advertise (target countries)
2. `dim="media"` → which publisher apps carry their ads (ad placements)
3. `dim="type"` → what creative formats they use
4. `dim="trend"` → how ad volume changes over time
5. `dim="lang"` → which languages they target
Combine all 5 for a comprehensive advertising strategy overview.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |