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

3006-Ad-Top Bidding Apps

POST
/app/asa/top-bidding-apps
Query the apps that bid on the same keywords as the specified App Store app, sorted by impression share in descending order. The result includes the queried app itself. Only App Store apps are supported.
Credits: Charged per call by date × limit. No credits are charged when no data is returned.
limit \ dateDAY_7DAY_30DAY_90
TOP_10102040
TOP_20204080
TOP_200200400600
TOP_4004008001000
ALL80010002000
Period date: DAY_7 (default) / DAY_30 / DAY_90. Days are counted in UTC+8 (Beijing time), so daily figures may differ from the FoxData website for regions it shows in UTC.
Limit limit: TOP_10 / TOP_20 / TOP_200 (default) / TOP_400 / ALL.
App ID appId: App Store numeric app ID only. A Google Play package name returns a parameter error.
Impression share impressionShare: A decimal between 0 and 1 rounded to 4 places (0.0950 means 9.50%); null when it cannot be calculated.

Request

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

Example
{
  "appId": "6746785267",
  "region": "US",
  "date": "DAY_7",
  "limit": "TOP_200"
}

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/top-bidding-apps' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "appId": "6746785267",
  "region": "US",
  "date": "DAY_7",
  "limit": "TOP_200"
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
  "requestParam": {
    "appId": "6746785267",
    "region": "US",
    "date": "DAY_7",
    "limit": "TOP_200"
  },
  "result": [
    {
      "appId": "6746785267",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/example/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/88x88w.png",
      "title": "Example App",
      "subtitle": "Example subtitle",
      "impressionShare": 0.095
    },
    {
      "appId": "1234567890",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/example2/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/88x88w.png",
      "title": "Example Competitor",
      "subtitle": null,
      "impressionShare": 0.0612
    }
  ],
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 200,
    "extraCredits": 0,
    "totalCostCredits": 200
  },
  "next": null
}
Modified at 2026-11-19 08:52:23
Previous
3005-ASA Tab Rate Result
Next
3007-Ad-App Creatives
Built with