App New Rank List API
API Information
- API Name: Get New Apps Rank List
- Request Method: POST
- API URL:
/open-api/v1/data - API Path:
/v3/api/open/rank/app-new/list - API Description: Get app new rank list information based on filter conditions, supports pagination
- Pricing: Retrieving one data result consumes 1 credit
Request Headers:
- Content-Type: application/json
- Accept: application/json
Request Parameters
Request Structure
| Parameter Name | Type | Description | Example | Required | Default |
|---|---|---|---|---|---|
key | string | User's external API request key | "your_api_key_here" | Yes | |
uri | string | Interface path | "/v3/api/open/rank/app-new/list" | Yes | |
params | object | Interface input parameters object | See parameter list below | Yes |
Parameter List (params object)
| Parameter Name | Type | Description | Example | Required | Default |
|---|---|---|---|---|---|
current_page | integer | Current page number | 1 | Yes | |
found_time | double | Discovery time range: 0-default, 1-3 days, 2-7 days, 3-1 month, 4-3 months, 5-6 months, 6-all | 1 | Yes | |
page_size | integer | Page size | 20 | Yes | |
sort_key | string | Sort field: count_growth-play count growth, growth_rate-growth rate, video_count-ad count | "count_growth" | Yes | |
sort_type | string | Sort type: desc-descending, asc-ascending | "desc" | Yes | |
type | integer | Time type: 0-default, 1-24 hours, 2-3 days, 3-7 days | 1 | Yes | |
create_time_type | integer | Creation time types: 1 to 6 recent 3 days, recent 7 days, recent 1 month, recent 3 months, recent 6 months, all | 1 | Yes | |
app_category | string | App category, multiple separated by commas | "id6003,id6023" | No | |
app_system | string | App system: ios/android | "ios" | No | |
app_type | string | App type: app/game | "app" | No | |
count_growth_max | double | Data growth maximum value (play count growth) | 1000000 | No | |
count_growth_min | double | Data growth minimum value (play count growth) | 1000 | No | |
growth_rate_max | double | Data growth rate maximum value | 1.0 | No | |
growth_rate_min | double | Data growth rate minimum value | 0.1 | No | |
plat_type | integer | Platform type: 0-all platforms, 1-TikTok, 2-Facebook | 1 | No | |
region | string | Target regions, multiple separated by commas | "US,CA,GB" | No |
Request Example
curl -X POST "https://www.pipispy.com/open-api/v1/data" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"key": "your_api_key_here",
"uri": "/v3/api/open/rank/app-new/list",
"params": {
"current_page": 1,
"found_time": 1,
"page_size": 20,
"sort_key": "count_growth",
"sort_type": "desc",
"type": 1,
"app_category": "id6003,id6023",
"app_system": "ios",
"app_type": "app",
"count_growth_min": 1000,
"count_growth_max": 1000000,
"growth_rate_min": 0.1,
"growth_rate_max": 1.0,
"plat_type": 1,
"region": "US,CA,GB"
}
}'
Response Parameters
Response Body Structure
{
"code": 200,
"message": "success",
"data": {
"data": [
// App rank list items
],
"page": {
// Pagination information
}
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 20,
"success": true,
"fail": false
}
Response Field Description
Main Response Fields
| Field Name | Type | Description |
|---|---|---|
code | integer | Response status code |
message | string | Response message |
data | object | Response data object |
version | string | API version number |
timestamp | integer/null | Timestamp |
sign | string/null | Signature |
remaining_credits | number | Current remaining available credits after this request |
consumed_credits | number | Credits consumed by this request |
success | boolean | Whether successful |
fail | boolean | Whether failed |
Data Object Fields
| Field Name | Type | Description |
|---|---|---|
data | array[object] | App rank list |
page | object | Pagination information |
Data Item Fields
| Field Name | Type | Description |
|---|---|---|
id | string | App unique identifier ID |
app_name | string | App name |
icon | string | App icon URL |
platform | array[string] | Platform list, e.g. ["tiktok", "facebook"] |
region | array[string] | Target regions list, e.g. ["US", "CA", "GB"] |
app_category | object | App category information |
app_rate | object | App rating information |
app_type | string | App type (app/game) |
app_store | string | App store (apple/google) |
app_download_count | long | Download count |
app_comment_count | long | Comment count |
play_count | long | Play count |
video_count | long | Video count |
digg_count | long | Like count |
put_day | integer | Days since launch |
found_time | long | Discovery timestamp |
latest_found_time | long | Latest discovery timestamp |
is_collection | boolean | Whether already collected |
last_month_revenue | object | Last month revenue information |
play_count_growth_rate | double | Play count growth rate |
digg_growth_rate | double | Like growth rate |
latest_download_count | long | Latest download count |
app_dev_info | object | Developer information |
created_time | long | Creation timestamp |
App Category Object Fields
| Field Name | Type | Description |
|---|---|---|
id | string | Category ID |
name | string | Category name |
type | string | Category type |
app_system | string | App system |
children | array[object] | Sub-category list |
App Rating Object Fields
| Field Name | Type | Description |
|---|---|---|
score | double | Rating score |
count | long | Rating count |
Revenue Object Fields
| Field Name | Type | Description |
|---|---|---|
unit | string | Unit (cent) |
currency | string | Currency type (USD) |
type | string | Type (currency) |
value | long | Revenue value (cents) |
Developer Info Object Fields
| Field Name | Type | Description |
|---|---|---|
name | string | Developer name |
icon | string | Developer icon |
id | string | Developer ID |
email | string | Developer email |
url | string | Developer link |
website_url | string | Website link (optional) |
avatar | string | Avatar (optional) |
Page Object Fields
| Field Name | Type | Description |
|---|---|---|
total_count | number | Total count |
page_count | number | Total page count |
current_page | number | Current page number |
page_size | number | Page size |
is_next | boolean | Whether has next page |
Response Example
{
"code": 200,
"message": "success",
"data": {
"data": [
{
"platform": ["tiktok"],
"id": "44eced5a4740e4062566",
"icon": "https://cdn-app.pipispy.com/f1e8e137f2582e41f5e7bccd327e954d.jpg",
"region": ["ID", "JP", "SG", "US", "TH", "MY", "CA"],
"app_name": "Lemon8 - Lifestyle Community",
"app_category": {
"id": "googleapp",
"name": "App",
"type": "app",
"app_system": "android",
"children": [
{
"id": "LIFESTYLE",
"name": "Lifestyle",
"type": "app",
"app_system": "android"
}
]
},
"app_rate": {
"score": 4.7058825,
"count": 201979
},
"app_type": "app",
"app_store": "google",
"app_download_count": 28744075,
"app_comment_count": 202439,
"play_count": 352576845,
"video_count": 396,
"digg_count": 13886211,
"put_day": 717,
"found_time": 1690011301,
"latest_found_time": 1752131772,
"is_collection": false,
"last_month_revenue": {
"unit": "cent",
"currency": "USD",
"type": "currency",
"value": 100000
},
"play_count_growth_rate": 0.1841,
"digg_growth_rate": 0.3007,
"latest_download_count": 1000000,
"app_dev_info": {
"name": "TikTok Pte. Ltd.",
"icon": "f1e8e137f2582e41f5e7bccd327e954d.jpg",
"id": "8354621850408287155",
"email": "[email protected]",
"url": "https://play.google.com/store/apps/developer?id=TikTok+Pte.+Ltd."
},
"created_time": 1583425601
}
],
"page": {
"total_count": 6645,
"page_count": 333,
"current_page": 1,
"page_size": 20,
"is_next": true
}
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 20,
"success": true,
"fail": false
}
Error Code Description
| Error Code | Description |
|---|---|
200 | Success |
400 | Bad Request - Invalid parameters |
401 | Unauthorized - Invalid API key |
500 | Internal Server Error |