3004-Ad-CPPs

POST

/cpp/ad

Query CPP ad records by country, category, and keyword.

Request

Authorization

Add parameter in header

x-openapi-key

Example:

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

Body Params application/json

Example

{
  "region": "CN",
  "category": "",
  "keyword": "加速器",
  "dateRangeType": "DAY_7",
  "limit": "TOP_200"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.foxdata.com/apiv1/open-api/cpp/ad' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "region": "CN",
  "category": "",
  "keyword": "加速器",
  "dateRangeType": "DAY_7",
  "limit": "TOP_200"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "requestParam": {
    "region": "CN",
    "category": "",
    "keyword": "加速器",
    "dateRangeType": "DAY_7",
    "limit": "TOP_200"
  },
  "result": {
    "appInfoMap": {
      "741292507": {
        "appName": "小红书 – 你的生活兴趣社区",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/4d/03/58/4d035872-ed76-5454-db0a-b5c608a510a3/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/88x88w.png"
      }
    },
    "cpps": [
      {
        "appId": "1244505010",
        "content": [
          "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/72/0e/50720e7a-b797-623f-1682-02fc6f019dbe/754342b4-025f-4a5d-b821-3dd4dbbbeeca_1.png/720x0w.png",
          "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/99/68/5c996881-7f22-e1ac-af29-277a30be17eb/43434a58-2d53-4003-8489-13d1cb1f51a6_2.png/720x0w.png"
        ],
        "firstOccurTime": null,
        "lastOccurTime": null,
        "keywords": [
          {
            "keyword": "steam",
            "pop": 81
          },
          {
            "keyword": "pubg mobile",
            "pop": 78
          }
        ]
      }
    ]
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 500,
    "extraCredits": 0,
    "totalCostCredits": 500
  },
  "next": null
}

Modified at 2026-06-25 05:44:00

3003-Ad-Bidding Keyword Analysis

3005-ASA Tab Rate Task