search_creatives
Search mobile game ad creatives by keyword or visual-description-like natural language. For an English request, send the original English concepts only. The service internally expands genre, hook, mood, art-style, and gameplay-mechanic concepts to Chinese source-label equivalents for retrieval; generated translations must not be inserted into the public request. Use this for finding UGC-style ads, winning creatives, opening hook examples, playable ads, and platform/country/genre slices. Results include the original creative asset as media_url when available. Creative tag fields are normalized to English in the result. Example: 'Find UGC-style match-3 video ads in the US.'
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| genre | No | Game genre or sub-genre in the user's original language, for example match-3, puzzle, or SLG. Chinese source-label expansion is internal. | |
| limit | No | Number of creatives to return. Maximum 20. | |
| query | Yes | Natural-language search query in the user's original language. Do not append generated Chinese translations to an English query; the service performs Chinese source-label expansion internally. | |
| format | No | Creative format: image, video, or playable. | |
| country | No | ISO 3166-1 alpha-2 country code, for example US, JP, KR, GB. | |
| platform | No | Ad platform filter. Supported values: facebook, instagram, messenger, audience_network, threads, admob, youtube, tiktok, mintegral, unity, applovin, ironsource, vungle, pangle. | |
| date_range | No | Date range. Supports last_7_days, last_30_days, last_90_days, or 'YYYY-MM-DD..YYYY-MM-DD'. Defaults to last_90_days. | |
| orientation | No | Optional creative orientation: portrait, landscape, or square. For video, this is derived from existing media width and height metadata. |