App Detail API
- API Name: Get App Detail
- Request Method: POST
- API URL:
/open-api/v1/data
- Interface URI path:
/v3/api/open/app/detail
- Description: Get detailed information of app by app ID
- Pricing: Details API pricing rules: Base fee: 1 credit/request. Free access conditions (if either is met): Details for this ID have been retrieved within the past 3 days; This ID appeared in your leaderboard list query results within the past 3 days.
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 URI path |
"/v3/api/open/app/detail" |
Yes |
|
| params |
object |
Interface parameter object |
See parameter list below |
Yes |
|
Parameter List (params object)
| Parameter Name |
Type |
Description |
Example |
Required |
Default |
| id |
string |
App ID |
"61d787d667dcc8ca6a82" |
Yes |
|
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/app/detail",
"params": {
"id": "61d787d667dcc8ca6a82"
}
}'
Response Parameters
Response Body Structure
{
"code": 200,
"message": "success",
"data": {
// App detail information
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
Response Field Description
Main Response Fields
| Field Name |
Type |
Description |
| id |
string |
App ID |
| name |
string |
App name |
| icon |
string |
App icon URL |
| rate |
object |
Rating information |
| url |
string |
App store link |
| app_download_count |
number |
App download count |
| app_comment_count |
number |
App comment count |
| desc |
string |
App description |
| app_system |
string |
App system (ios/android) |
| app_store |
string |
App store (apple/google) |
| app_type |
string |
App type (app/game) |
| app_category |
object |
App category information |
| app_create_time |
number |
App creation time (timestamp) |
| app_update_time |
number |
App update time (timestamp) |
| ad_platform_list |
array |
Ad platform list |
| app_dev |
object |
Developer information |
| is_collection |
boolean |
Is collected |
| revenue |
object |
Revenue information |
| last_month_app_download_count |
number |
Last month download count |
| images |
array |
App screenshot list |
| all_data_count |
number |
Total data count |
| top_region |
array |
Top regions |
| top_in_app_purchases |
array |
In-app purchase information |
| keywords |
array |
Keyword list |
Rate Object Fields
| Field Name |
Type |
Description |
| score |
number |
Rating score |
| count |
number |
Rating count |
| rate1 |
number |
1-star rating count |
| rate2 |
number |
2-star rating count |
| rate3 |
number |
3-star rating count |
| rate4 |
number |
4-star rating count |
| rate5 |
number |
5-star rating count |
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 |
| app_store |
string |
App store |
| children |
array |
Sub-category list |
App Developer Object Fields
| Field Name |
Type |
Description |
| id |
string |
Developer ID |
| name |
string |
Developer name |
| email |
string |
Developer email |
| url |
string |
Developer URL |
| icon |
string |
Developer icon URL |
| avatar |
string |
Developer avatar URL |
| website_url |
string |
Developer website URL (optional) |
Revenue Object Fields
| Field Name |
Type |
Description |
| unit |
string |
Revenue unit (cent) |
| currency |
string |
Currency type (USD, etc.) |
| type |
string |
Revenue type (currency) |
| value |
number |
Revenue value (in cents) |
In-App Purchase Object Fields
| Field Name |
Type |
Description |
| price |
string |
Price range description |
Keyword Object Fields
| Field Name |
Type |
Description |
| name |
string |
Keyword name |
| url |
string |
Keyword search URL |
Root Level Response Fields
| Field Name |
Type |
Description |
| code |
number |
Response status code |
| message |
string |
Response message |
| data |
object |
App detail data |
| version |
string |
API version |
| timestamp |
number/null |
Timestamp |
| sign |
string/null |
Signature |
| remaining_credits |
Long |
Current remaining available credits after this request |
| consumed_credits |
Long |
Credits consumed by this request |
| success |
boolean |
Request success status |
| fail |
boolean |
Request failure status |
Response Example
{
"code": 200,
"message": "success",
"data": {
"id": "69474be0ed2cecb479b1",
"name": "Stickman vs Monster: Idle RPG",
"icon": "https://cdn-app.pipispy.com/86f80c31e7712aa1ff486b1ff210028b.jpg",
"rate": {
"score": 4.8965516,
"count": 12565,
"rate1": 216,
"rate2": 0,
"rate3": 0,
"rate4": 433,
"rate5": 11916
},
"url": "https://play.google.com/store/apps/details?id=com.stickman.monster.epic.stickman.war.shadow.idle.game",
"app_download_count": 1528081,
"app_comment_count": 12566,
"desc": "<b>Idle Gameplay, Epic Rewards</b><br>Stickman vs Monster offers a relaxed and enjoyable gaming experience...",
"app_system": "android",
"app_store": "google",
"app_type": "game",
"app_category": {
"id": "googlegame",
"name": "Game",
"type": "game",
"children": [
{
"id": "GAME_ROLE_PLAYING",
"name": "Role Playing",
"type": "game",
"app_system": "android"
}
],
"app_system": "android"
},
"app_create_time": 1736218411,
"app_update_time": 1750895087,
"ad_platform_list": ["tiktok"],
"app_dev": {
"id": "7752608683054605616",
"name": "Fansipan Limited",
"email": "[email protected]",
"url": "https://play.google.com/store/apps/dev?id=7752608683054605616",
"icon": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg",
"avatar": "https://cdn-app.pipispy.com/c8bb0c844b7fe66799bed62b7da8a166.jpg"
},
"is_collection": false,
"revenue": {
"unit": "cent",
"currency": "USD",
"type": "currency",
"value": 2000000
},
"last_month_app_download_count": 200000,
"images": [
"https://cdn-app.pipispy.com/c37bd0ad1bb037fd89f174846d2b434f.jpg",
"https://cdn-app.pipispy.com/59ba6218aa9ac9c8de05aef730d0f9d9.jpg",
"https://cdn-app.pipispy.com/f71de19f71464fa8a2070f37362ac812.jpg"
],
"all_data_count": 937,
"top_region": ["US", "VN", "TW"],
"top_in_app_purchases": [
{
"price": "$1.49 - $99.99 per item"
}
],
"keywords": [
{
"name": "Idle RPG",
"url": "/store/search?q=Idle+RPG+games&c=apps"
},
{
"name": "Stylized",
"url": "/store/search?q=Stylized+games&c=apps"
},
{
"name": "Monster",
"url": "/store/search?q=Monster+games&c=apps"
},
{
"name": "Stickman",
"url": "/store/search?q=Stickman+games&c=apps"
}
]
},
"version": "v1",
"timestamp": null,
"sign": null,
"remaining_credits": 9980,
"consumed_credits": 1,
"success": true,
"fail": false
}
Error Code Description
| Error Code |
Description |
| 200 |
Success |
| 400 |
Bad Request - Invalid parameters |
| 401 |
Unauthorized - Invalid API key |
| 404 |
Not Found - App not found |
| 500 |
Internal Server Error |