FoxData Open API
My License
My License
  1. LIST OF APIS
  • REFERENCE
    • Make Your First API Request
    • API Billing Rules
  • COMMON PARAMS
    • App Store Categories
    • Google Play Categories
    • Supported Countries/Languages
  • LIST OF APIS
    • App Metadata
      POST
    • App Metadata History
      POST
    • App Category Ranking
      POST
    • App Category Ranking History
      POST
    • App Metrics
      POST
    • App Metrics History
      POST
    • App Keyword
      POST
    • App Keyword History
      POST
    • Keywords Metrics
      POST
    • Keywords Metrics History
      POST
  1. LIST OF APIS

App Metadata History

POST
/expose/app/app-info-history
Credits Cost
Cost TypeCost Credits
Request Credits1
Base Credits10
Extra Credits1 per day

Request

Header Params
x-openapi-key
string 
required
Default:
Your License
Body Params application/json
Your request param.
appId
string 
required
Application ID or packageName
region
string 
required
Two character region code,like US.
Default:
US
gpLanguage
string  | null 
optional
Display language, only for GooglePlay query.
Default:
en
timezone
integer  | null 
optional
Your timezone,enter 8 for UTC+8,enter -7 for UTC-7.
device
enum<string>  | enum<null> 
optional
App Store Device, only for AppStore query.
Allowed values:
IPHONEIPAD
start
string  | null 
required
Start Date
end
string  | null 
required
End Date
Example
{
  "appId": "string",
  "region": "US",
  "gpLanguage": "en",
  "timezone": 0,
  "device": "IPHONE",
  "start": "string",
  "end": "string"
}

Request 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 --request POST 'https://api.foxdata.com/apiv1/expose/app/app-info-history' \
--header 'x-openapi-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "region": "US",
    "gpLanguage": "en",
    "timezone": 0,
    "device": "IPHONE",
    "start": "string",
    "end": "string"
}'

Responses

🟢200Success
application/json
Body
requestParam
object (AppInfoHistoryQuery) 
optional
Your request param.
appId
string  | null 
required
Application ID or packageName
region
string  | null 
required
Two character region code,like US.
Default:
US
gpLanguage
string  | null 
optional
Display language, only for GooglePlay query.
Default:
en
timezone
integer  | null 
optional
Your timezone,enter 8 for UTC+8,enter -7 for UTC-7.
device
enum<string>  | enum<null> 
optional
App Store Device, only for AppStore query.
Allowed values:
IPHONEIPAD
start
string  | null 
required
Start Date
end
string  | null 
required
End Date
result
object (AppHistoryInfoVO) 
optional
Your response.
data
array[object (ChangeData«?») {5}]  | null 
optional
App Info HistoryData
creditsCost
object (OpenApiPointCostVO) 
optional
Credits cost info.
requestCredits
integer  | null 
optional
baseCredits
integer  | null 
optional
extraCredits
integer  | null 
optional
totalCostCredits
integer  | null 
optional
Example
{
  "code": 200,
  "msg": "success",
  "data": {
    "requestParam": {
      "appId": "1621328561",
      "region": "US",
      "gpLanguage": "en",
      "timezone": 8,
      "device": "IPHONE",
      "start": "2024-04-01",
      "end": "2024-05-14"
    },
    "result": {
      "data": [
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-01T23:00:00",
          "version": "1.21.2",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/45asVHEnirm1Keixnoeppw/1120x700w.png",
              "startTime": 1711983600,
              "endTime": 1713279600,
              "status": "FINISHED",
              "subtitle": "Grow your Net Worth to become the #1 mogul!",
              "desc": "Join Mr. M and his friends and get rolling to become the richest mogul around!",
              "name": "Play Like Top Tycoons!",
              "kind": "LIVE EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6479705342",
              "promotionTime": 1711983600
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-04T23:00:00",
          "version": "1.21.2",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/bwfKOH3YI-uS0vZPhvBWXA/1120x700w.png",
              "startTime": 1712242800,
              "endTime": 1712415600,
              "status": "FINISHED",
              "subtitle": "Which riches does the river have to offer?",
              "desc": "Sail along the river to find rolls, sticker packs, and delightful deals!",
              "name": "Thames Fortunes!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6478460397",
              "promotionTime": 1711609200
            },
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/olm5-744oEzzf1PxwkIw7g/1120x700w.png",
              "startTime": 1712242800,
              "endTime": 1712415600,
              "status": "FINISHED",
              "subtitle": "Put the pedal to the metal & win BIG!",
              "desc": "Join Mr. M for our London Games celebrations and take part in the double-decker derby for some ROYAL rewards!",
              "name": "Double Decker Derby!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6478460398",
              "promotionTime": 1711609200
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-06T20:30:00",
          "version": "1.21.2",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/9-PQGPuxWqV1V_kZHiJb7w/1120x700w.png",
              "startTime": 1712406600,
              "endTime": 1712865600,
              "status": "FINISHED",
              "subtitle": "Chisel away for magnificent prizes!",
              "desc": "Partner with fellow tycoons and build fountains together on your way to a new token!",
              "name": "Fountain Partners!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6480063854",
              "promotionTime": 1712406600
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-16T21:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/mnmoJNbDUEc94htdW_AKPw/1120x700w.png",
              "startTime": 1713272400,
              "endTime": 1713643200,
              "status": "FINISHED",
              "subtitle": "Join Sofia on her sweet, festive adventure!",
              "desc": "Roll in, collect cake servers, and have a bite of delicious rewards on your way to a Wild Sticker!",
              "name": "Anniversary Treasures",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6480371845",
              "promotionTime": 1713272400
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-16T23:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/1SXVKDxzaBB4ITRPtCqwbw/1120x700w.png",
              "startTime": 1713279600,
              "endTime": 1714575600,
              "status": "FINISHED",
              "subtitle": "Join the MONOPOLY GO! 1st anniversary party!",
              "desc": "Party with Mr. M and friends as we celebrate 1 year of MONOPOLY GO! with festive events & fun rewards!",
              "name": "Our Anniversary is a GO!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6480371874",
              "promotionTime": 1713279600
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-20T23:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/m-j1ZiLmiSS4Ml0ap99iOQ/1120x700w.png",
              "startTime": 1713625200,
              "endTime": 1713884400,
              "status": "FINISHED",
              "subtitle": "Party like the tycoon you are in MONOPOLY GO!",
              "desc": "Keep our 1-year anniversary party rolling with extra rolls and two sticker packs!",
              "name": "Celebratory Special!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6480371871",
              "promotionTime": 1713625200
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-04-26T20:30:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/578-cLO83Vy6jI6sGSMrZQ/1120x700w.png",
              "startTime": 1714134600,
              "endTime": 1714593600,
              "status": "FINISHED",
              "subtitle": "The parade is rolling to your boards!",
              "desc": "Partner up with fellow tycoons, build your floats together, and march towards festive rewards!",
              "name": "Parade Partners!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6480063680",
              "promotionTime": 1714134600
            }
          ]
        },
        {
          "type": "ICON",
          "dateTime": "2024-04-29T08:00:00",
          "version": "1.22.0",
          "oldVal": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/a4/9e/35/a49e35df-1067-ac1d-d919-52416f030c91/AppIcon-1x_U007emarketing-0-7-0-85-220.png/{w}x{h}{c}.{f}",
          "newVal": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/0d/c1/d8/0dc1d83f-e922-0a40-806b-097fd9f5860a/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/{w}x{h}{c}.{f}"
        },
        {
          "type": "VERSION",
          "dateTime": "2024-04-29T08:00:00",
          "version": "1.22.0",
          "oldVal": "1.21.2",
          "newVal": "1.22.0"
        },
        {
          "type": "VIDEO",
          "dateTime": "2024-04-29T08:00:00",
          "version": "1.22.0",
          "oldVal": [
            {
              "image": "https://is1-ssl.mzstatic.com/image/thumb/PurpleVideo116/v4/ff/c6/e6/ffc6e6b8-a92d-7bf0-5b5b-d3788dd0cffc/Jobcb1ad3bc-ec68-48a5-9853-57ac5710bbb5-149484228-PreviewImage_preview_image_nonvideo_sdr-Time1683021070851.png/{w}x{h}{c}.{f}",
              "video": "https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo116/v4/bd/d3/f6/bdd3f65a-e562-a773-4287-0be6dce2149a/P576353017_default.m3u8"
            }
          ],
          "newVal": [
            {
              "image": "https://is1-ssl.mzstatic.com/image/thumb/PurpleVideo221/v4/60/dc/52/60dc5238-dcaa-b565-7977-daca871c3206/Job62f92e33-6562-4e0a-bb9a-b1e0746bf92b-166187943-PreviewImage_Preview_Image_Intermediate_nonvideo_322977521_1739241120-Time1712929712264.png/{w}x{h}{c}.{f}",
              "video": "https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo221/v4/75/89/83/75898324-dee0-f770-ff20-f5e7b633e540/P848236405_default.m3u8"
            }
          ]
        },
        {
          "type": "SCREENSHOT",
          "dateTime": "2024-04-29T08:00:00",
          "version": "1.22.0",
          "oldVal": [
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/69/2d/f4/692df484-0768-95fd-5d31-8974ad529193/105a1d69-b5c0-4fd7-90b4-e174763560eb_MPY-17770_Monopoly_Gamefeature_Screenshots_Resizes_1242x2208_SS1_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/b5/19/c0/b519c072-d245-b0db-a567-542bb05a21de/410ef86a-6c68-4124-96be-d1e83b7c5000_MPY-17770_Monopoly_Gamefeature_Screenshots_Resizes_1242x2208_SS2_V2.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/76/17/97/761797e5-d901-8626-a72c-a019a4f6c949/cba259b8-730c-45ee-8f5f-bf6d2115628b_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS3_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/61/fd/e4/61fde439-a5d4-4303-6d86-cc58c11b53db/48530ee5-3f4a-4523-ac28-367a342e225e_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS4_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/52/af/b1/52afb154-ec0b-c57e-1169-e489bff0a489/02886e17-b75b-4581-b42c-a181b87171fe_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS5_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/bf/43/3d/bf433db9-b54f-9bb0-7a10-c13d65989392/6552e1d5-1c81-4069-8b4d-baf73efb8b03_MPY-17770_Monopoly_Gamefeature_Screenshots_Resizes_1242x2208_SS6_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/c4/59/2c/c4592c8f-fb0f-7cac-7b45-d5cb220c6ad5/e79a16a5-85a0-4e01-9630-045a2f701c16_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS7_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/62/cb/9e/62cb9ea4-4ed8-800e-cab4-5e94eee3ce09/ce3163c4-3a3a-4b34-b176-55e1d8213ce4_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS8_V1.jpg/{w}x{h}{c}.{f}"
          ],
          "newVal": [
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/66/53/e1/6653e19e-f88c-b5ef-8771-befec32eb09a/f829b3f2-bf55-49f2-b430-c8b3bf1ccb8f_MPY-34545_ANNIVERSARY-SCREENSHOTS_EN_1242x2208_SS1_v7_coibs33hgk.png/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/18/57/e6/1857e6d4-2c2f-d809-af19-e89899a3c8de/769e69fc-d0a4-4ca7-ac4c-d869768ca84c_MPY-34545_ANNIVERSARY_SCREENSHOTS_EN_1242x2208_SS2_v7_io1okwblpx.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/8e/34/f9/8e34f939-953b-80a5-ad14-c9101d105e69/ff618d44-4d2f-44f7-942c-7e117159e01a_MPY-34545_ANNIVERSARY_SCREENSHOTS_EN_1242x2208_SS3_v7_v9mddz7mkr.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8f/19/4c/8f194c88-6544-af12-ad40-e0e3aa401490/48530ee5-3f4a-4523-ac28-367a342e225e_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS4_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/0a/7a/bb/0a7abbcc-fb68-c2f3-536e-c3bb7a5a9c9b/02886e17-b75b-4581-b42c-a181b87171fe_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS5_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/31/92/5c/31925ccb-7ccb-d9e8-1bfa-ad3d35e72633/6552e1d5-1c81-4069-8b4d-baf73efb8b03_MPY-17770_Monopoly_Gamefeature_Screenshots_Resizes_1242x2208_SS6_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/dd/8a/0e/dd8a0e0e-54ea-b8d7-d238-fad9694c51c2/e79a16a5-85a0-4e01-9630-045a2f701c16_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS7_V1.jpg/{w}x{h}{c}.{f}",
            "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/45/77/4e/45774e69-34c8-711a-44ae-6b62e780c009/ce3163c4-3a3a-4b34-b176-55e1d8213ce4_MPY-17770_Gamefeature_Monopoly_Screenshots_Resizes_1242x2208_SS8_V1.jpg/{w}x{h}{c}.{f}"
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-05-03T21:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/EurnLm2aQMev-0rHndc7Zw/1120x700w.png",
              "startTime": 1714741200,
              "endTime": 1715112000,
              "status": "FINISHED",
              "subtitle": "The jungle's lost fortunes await!",
              "desc": "Join Sofia to dig out a new shield, a new token, and more Nocturnal Treasures to win a Wild Sticker!",
              "name": "Nocturnal Treasures!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6484273307",
              "promotionTime": 1714741200
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-05-03T23:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/FpxOGib4E9MSuPOWN9PLjg/1120x700w.png",
              "startTime": 1714748400,
              "endTime": 1715266800,
              "status": "FINISHED",
              "subtitle": "Join the prize fiesta, Tycoons!",
              "desc": "Celebrate Cinco de Mayo with sizzling events and spicy rewards!",
              "name": "Happy Cinco de Mayo!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6484273118",
              "promotionTime": 1714748400
            }
          ]
        },
        {
          "type": "IN_APP_EVENTS",
          "dateTime": "2024-05-12T23:00:00",
          "version": "1.22.0",
          "oldVal": null,
          "newVal": [
            {
              "url": "https://is1-ssl.mzstatic.com/image/thumb/gDv16RQbZ6L9Q3qUZ85gJA/1120x700w.png",
              "startTime": 1715526000,
              "endTime": 1715612400,
              "status": "FINISHED",
              "subtitle": "Make this day an unforgettable one!",
              "desc": "Celebrate this special day with rewarding prizes!",
              "name": "Happy Mother's Day!",
              "kind": "SPECIAL EVENT",
              "deepLink": "https://apps.apple.com/us/app/monopoly-go/id1621328561?eventid=6497405521",
              "promotionTime": 1715526000
            }
          ]
        }
      ]
    },
    "creditsCost": {
      "requestCredits": 1,
      "baseCredits": 10,
      "extraCredits": 8,
      "totalCostCredits": 19
    }
  }
}
Previous
App Metadata
Next
App Category Ranking
Built with