FoxData Open API
My License
My License
  1. 3. ASA Services
  • I. Quick Start
    • 1. API Overview
    • 2. Quick Start
    • 3. Authorization
    • 4. Request & Response
    • 5. Rate Limiting
  • II. List of Interfaces
    • 1. application Services
      • 1001-App-Basic Info
      • 1002-App-Extended Info
      • 1003-App-Visibility Score
      • 1004-App-Apps by Same Developer
      • 1005-App-Ranking History
      • 1006-App-Featured Recommendations
      • 1007-App-Ratings & Reviews
      • 1008-App-Version History
      • 1009-App-Competitor Comparison
      • 1010-App-Competitor Bidding
      • 1011-App-Covered Keywords
      • 1012-App-Keyword Expansion
      • 1013-App-Bidding Keywords
      • 1014-App-Bidding Keyword Periodic Monitoring-Task Initiation
      • 1014-App-Bidding Keyword Periodic Monitoring-Task Retrieval
      • 1014-App-Bidding Keyword Periodic Monitoring-Data Retrieval
      • 1015-App-CPP Ad Creatives
      • 1016-App-App Tags
      • 1017-App-Download & Revenue Estimates
      • 1018-App-Smart Keyword Recommendations
      • 1019-App-Active Users
      • 1020-App-Basic Info (Advanced)
      • 1021-App-CPP Keywords
    • 2. Market Services
      • 2001-Market-Realtime Charts
      • 2002-Market-Global Chart Analysis
      • 2003-Market-Search Volume Charts
      • 2004-Market-Download & Revenue Charts
      • 2005-Market-Active Users & Customers
      • 2006-Market-App Release Monitoring
      • 2007-Market-Cleared Keyword Monitoring
      • 2008-Market-Cleared Ranking Monitoring
      • 2009-Market-App Delisting Monitoring
    • 3. ASA Services
      • 3001-Ad-Bidding Apps
        POST
      • 3002-Ad-Bidding Keywords
        POST
      • 3003-Ad-Bidding Keyword Analysis
        POST
      • 3004-Ad-CPPs
        POST
      • 3005-ASA Tab Rate Task
        POST
      • 3005-ASA Tab Rate Result
        POST
      • 3006-Ad-Top Bidding Apps
        POST
      • 3007-Ad-App Creatives
        POST
      • 3008-Ad-ASA Bidding Keyword Count History
        POST
    • 4. Kerword research Services
      • 4001-Keyword Search
      • 4002-Keyword Expansion
      • 4003-Keyword Search Details
      • 4004-App-App Keywords
    • 9. Other Services
      • 9001-Paginated Query API
  • III. Data Dictionary and Definitions
    • 1. Application Classification Code
    • 2. Time and Location Information
    • 3. Regional Language Comparison Chart
    • 4. Explanation of Data Update Frequency
  • IV. Appendix
    • 1. Release Notes
    • 2. FAQ
    • 3. Contact and Support
  1. 3. ASA Services

3008-Ad-ASA Bidding Keyword Count History

POST
/app/asa/keyword-count/history
Query the daily number of ASA bidding keywords of an App Store app in a specified country/region. Only App Store apps are supported.
Credits: Charged per call by the number of queried days (start and end dates inclusive): 10 credits for 7 days, plus 1 credit for each additional day; ranges shorter than 7 days are charged as 7 days. For example, 30 days cost 33 credits and 366 days cost 369 credits. No credits are charged when every day's num is null or 0.
Date rules: startTime and endTime are required, format yyyy-MM-dd, and days are counted in UTC+8 (Beijing time). startTime must not be after endTime, endTime must not be later than today, and startTime must not be earlier than 12 months before today. Otherwise a parameter error is returned.
Trend trend: One item for every day in [startTime, endTime], ascending by date. num is the number of distinct bidding keywords observed on that day, null when there is no data for that day. If the range includes today, today's value is the number of bidding keywords observed so far today.
No data: If there is no data for the whole range, appId, title, icon and the daily trend are still returned, with num null (or 0 for today), and no credits are charged.
App ID appId: App Store numeric app ID only. A Google Play package name returns a parameter error.

Request

Authorization
Add parameter in header
x-openapi-key
Example:
x-openapi-key: ********************
Body Params application/jsonRequired

Example
{
  "appId": "6746785267",
  "region": "US",
  "startTime": "2026-11-06",
  "endTime": "2026-11-12"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.foxdata.com/apiv1/open-api/app/asa/keyword-count/history' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "appId": "6746785267",
  "region": "US",
  "startTime": "2026-11-06",
  "endTime": "2026-11-12"
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
  "requestParam": {
    "appId": "6746785267",
    "region": "US",
    "startTime": "2026-11-06",
    "endTime": "2026-11-12"
  },
  "result": {
    "appId": "6746785267",
    "title": "Example App",
    "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/example/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/88x88w.png",
    "trend": [
      {
        "date": "2026-11-06",
        "num": 32
      },
      {
        "date": "2026-11-07",
        "num": 35
      },
      {
        "date": "2026-11-08",
        "num": null
      },
      {
        "date": "2026-11-09",
        "num": 30
      },
      {
        "date": "2026-11-10",
        "num": 41
      },
      {
        "date": "2026-11-11",
        "num": 38
      },
      {
        "date": "2026-11-12",
        "num": 36
      }
    ]
  },
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 10,
    "extraCredits": 0,
    "totalCostCredits": 10
  },
  "next": null
}
Modified at 2026-11-19 08:52:23
Previous
3007-Ad-App Creatives
Next
4001-Keyword Search
Built with