3007-Ad-App Creatives - FoxData Open API

Query ad creatives by app.

Credits: Charged per platform at 200 credits each. If platform is empty, all 8 platforms are counted (1600 credits total). No credits are charged when no data is returned.

Date rules: start and end must be provided together (format yyyy-MM-dd). If both are omitted, defaults to today. Providing only one of them, or start > end, returns a parameter error.

Sort field order: START_DATE (default) / END_DATE / DAYS / EXPOSURE.

Sort direction sortOrder: ASC / DESC (default DESC).

Limit limit: Currently only TOP_200 is supported.

Platform platform values: facebook / instagram / audience_network / messenger / threads / AdMob / YouTube / tiktok.

Request

Authorization

Add parameter in header

x-openapi-key

Example:

x-openapi-key: ********************

Body Params application/jsonRequired

Example

{
  "region": ["YE", "VN", "UZ"],
  "appId": "com.newleaf.app.android.victor",
  "start": "2026-01-01",
  "end": "2026-07-28",
  "platform": [
    "facebook",
    "instagram",
    "audience_network",
    "messenger",
    "AdMob",
    "YouTube",
    "threads",
    "tiktok"
  ],
  "order": "EXPOSURE",
  "sortOrder": "DESC",
  "limit": "TOP_200"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "requestParam": {
    "region": ["YE", "VN", "UZ"],
    "appId": "com.newleaf.app.android.victor",
    "start": "2026-01-01",
    "end": "2026-07-28",
    "platform": [
      "facebook",
      "instagram",
      "audience_network",
      "messenger",
      "AdMob",
      "YouTube",
      "threads",
      "tiktok"
    ],
    "order": "EXPOSURE",
    "sortOrder": "DESC",
    "limit": "TOP_200"
  },
  "result": {
    "appId": "com.newleaf.app.android.victor",
    "icon": "https://image3.foxdata.com/gp-proxy/example-icon",
    "title": "Example App",
    "Ads": [
      {
        "adId": "1234567890",
        "adThumb": {
          "adId": "1234567890",
          "collationCount": 3,
          "startDate": "2026-03-01",
          "endDate": "2026-07-10",
          "days": 132,
          "details": [
            {
              "type": "VIDEO",
              "size": 1024000,
              "height": 1920,
              "width": 1080,
              "videoUrl": "https://example.com/video.mp4",
              "imageUrl": "https://example.com/preview.jpg"
            }
          ]
        },
        "regions": ["VN", "YE"],
        "exposure": 15800,
        "exposureChange": 320,
        "sponsor": {
          "id": "sponsor_001",
          "name": "Example Advertiser",
          "igFollowers": 12000,
          "fbFollowers": 8500
        },
        "distribution": [
          {
            "region": "VN",
            "ageRange": "18-24",
            "gender": "male",
            "exposure": 5200
          }
        ],
        "tiktok": null
      }
    ]
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 1600,
    "extraCredits": 0,
    "totalCostCredits": 1600
  },
  "next": null
}