App Developer List API
- API Name: Get Developers List
- Request Method: POST
- API URL:
/open-api/v1/data
- API Path:
/v3/api/open/app-dev/list
- API Description: Get app developer 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/app-dev/list" |
Yes |
|
| params |
object |
Interface input parameters object |
See parameter list below |
Yes |
|
Parameter List (params object)
Required Parameters
| Parameter Name |
Type |
Description |
Example |
Required |
Default |
| current_page |
integer |
Current page number (required) |
1 |
Yes |
|
| page_size |
integer |
Page size (required) |
20 |
Yes |
|
| plat_type |
integer |
Platform type (required): 0-all, 1-tiktok, 2-facebook |
1 |
Yes |
|
| sort |
integer |
Sort field (required): 0-Number of ads,1-Impressions,2-Likes,4-Durations,7-Start Date,8-End Date,9-Number of apps,10-Installs,11-Monthly Installs,12-Monthly Revenue(USD) |
1 |
Yes |
|
| time |
long |
Time range (required): 0-last 7 days, 1-last 30 days, 2-last 90 days, 4-yesterday, 3-all time |
1640995200 |
Yes |
|
Optional Parameters (Alphabetical Order)
| Parameter Name |
Type |
Description |
Example |
Required |
Default |
| app_category |
array |
App category list, supports format: ["id6003", "id6023"] or ["6003", "6023"], system will automatically handle "id" prefix |
["id6003", "id6023"] |
No |
|
| app_comment_count_max |
long |
Ratings, Maximum app comment count |
100000 |
No |
|
| app_comment_count_min |
long |
Ratings, Minimum app comment count |
1000 |
No |
|
| app_count_max |
long |
Maximum app count |
100 |
No |
|
| app_count_min |
long |
Minimum app count |
1 |
No |
|
| app_download_count_max |
long |
Installs, Maximum app download count |
1000000 |
No |
|
| app_download_count_min |
long |
Installs, Minimum app download count |
1000 |
No |
|
| app_system |
string |
App system: ios-apple, android-android |
"ios" |
No |
|
| app_type |
string |
App type: app-application, game-game |
"app" |
No |
|
| cpm_max |
double |
Maximum CPM |
10.0 |
No |
|
| cpm_min |
double |
Minimum CPM |
1.0 |
No |
|
| digg_count_max |
long |
Likes, Maximum like count |
100000 |
No |
|
| digg_count_min |
long |
Likes, Minimum like count |
1000 |
No |
|
| digg_rate_max |
double |
Maximum like rate (range: 0.0-1.0) |
1.0 |
No |
|
| digg_rate_min |
double |
Minimum like rate (range: 0.0-1.0) |
0.1 |
No |
|
| end_time_end |
long |
End Date end (timestamp, corresponds to latest found time range) |
1643673600 |
No |
|
| end_time_start |
long |
End Date start (timestamp, corresponds to latest found time range) |
1640995200 |
No |
|
| goods_source_max |
long |
Maximum goods source count (Note: this field actually corresponds to data count field) |
1000 |
No |
|
| goods_source_min |
long |
Minimum goods source count (Note: this field actually corresponds to data count field) |
10 |
No |
|
| keyword |
string |
Search keyword, search method varies by searchType: 1-search both developer name and app name, 2-search app name only, 3-search developer name only |
"MercadoLibre" |
No |
|
| last_month_app_download_count_max |
long |
Monthly Installs, Maximum last month app download count |
50000 |
No |
|
| last_month_app_download_count_min |
long |
Monthly Installs, Minimum last month app download count |
1000 |
No |
|
| last_month_revenue_max |
long |
Monthly Revenue(USD), Maximum last month revenue (Note: system will automatically multiply by 100) |
100000 |
No |
|
| last_month_revenue_min |
long |
Monthly Revenue(USD), Minimum last month revenue (Note: system will automatically multiply by 100) |
1000 |
No |
|
| play_count_max |
long |
Impression, Maximum play count |
10000000 |
No |
|
| play_count_min |
long |
Impression, Minimum play count |
1000000 |
No |
|
| popular_person_count_max |
long |
Maximum popular person count |
100 |
No |
|
| popular_person_count_min |
long |
Minimum popular person count |
1 |
No |
|
| put_day_max |
long |
Ad Run Time, Maximum put day count |
30 |
No |
|
| put_day_min |
long |
Ad Run Time, Minimum put day count |
1 |
No |
|
| region |
array |
Country/Region, supports multiple region codes, e.g.: ["BR", "TW", "MX"] |
["BR", "TW", "MX"] |
No |
|
| search_type |
integer |
Search type: 1-search both developer name and app name (default), 2-search app name only, 3-search developer name only |
1 |
No |
1 |
| sort_type |
string |
Sort type: asc-ascending, desc-descending |
"desc" |
No |
"desc" |
| start_time_end |
long |
Start time end (timestamp, corresponds to first found time range) |
1643673600 |
No |
|
| start_time_start |
long |
Start time start (timestamp, corresponds to first found time range) |
1640995200 |
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/app-dev/list",
"params": {
"current_page": 1,
"page_size": 20,
"plat_type": 1,
"sort": 1,
"time": 1640995200,
"keyword": "MercadoLibre",
"region": ["BR", "TW", "MX"],
"app_type": "app",
"app_system": "ios"
}
}'
Response Parameters
Response Body Structure
{
"code": 200,
"message": "success",
"data": {
"data": [
// App developer list items
],
"page": {
// Pagination information
}
}
}
Response Field Description
Standard Response Fields
| Field Name |
Type |
Description |
| remaining_credits |
Long |
Current remaining available credits after this request |
| consumed_credits |
Long |
Credits consumed by this request |
Main Response Fields
| Field Name |
Type |
Description |
| data |
array[object] |
App developer list |
| page |
object |
Pagination information |
Data Item Fields
| Field Name |
Type |
Description |
| id |
string |
App developer unique identifier ID |
| name |
string |
App developer name |
| icon |
string |
App developer icon URL |
| ad_platform_list |
array |
List of advertising platforms (e.g., ["tiktok", "facebook"]) |
| app_system |
array |
List of app systems (e.g., ["ios", "android"]) |
| app_store |
array |
List of app stores (e.g., ["apple", "google"]) |
| app_count |
long |
App count |
| app_download_count |
long |
Total app download count |
| app_comment_count |
long |
Total app comment count |
| rate_score |
double |
App rating score |
| rate_count |
long |
Number of ratings |
| revenue |
object |
Revenue information object |
| found_time |
long |
First found time (timestamp) |
| last_found_time |
long |
Latest found time (timestamp) |
| last_month_app_download_count |
long |
Last month app download count |
| region |
array |
Target region list |
| is_collection |
boolean |
Whether already collected |
| goods_source_count |
long |
Goods source count (data count) |
| popular_person_count |
long |
Popular person count |
| put_day_change |
long |
Put day change count |
| play_change |
long |
Play count change |
| digg_change |
long |
Digg count change |
| latest_data |
array |
Latest data array with platform, URL, and count information |
Revenue Object Fields
| Field Name |
Type |
Description |
| unit |
string |
Unit of measurement (e.g., "cent") |
| currency |
string |
Currency code (e.g., "USD") |
| type |
string |
Type of value (e.g., "currency") |
| value |
long |
Revenue value |
Latest Data Object Fields
| Field Name |
Type |
Description |
| platform |
integer |
Platform identifier |
| url |
string |
Image URL |
| count |
long |
Count value |
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": [
{
"id": "1754094607",
"name": "NETSTORY PTE. LTD.",
"icon": "https://cdn-app.pipispy.com/801cee19685e5bef313e17e836c2df70.jpg",
"ad_platform_list": ["tiktok"],
"app_system": ["ios"],
"app_store": ["apple"],
"app_count": 1,
"app_download_count": 0,
"app_comment_count": 61883,
"rate_score": 4.6,
"rate_count": 61883,
"revenue": {
"unit": "cent",
"currency": "USD",
"type": "currency",
"value": 1100000000
},
"found_time": 1751558400,
"last_found_time": 1752076800,
"last_month_app_download_count": 0,
"region": [
"DE",
"TW",
"RU",
"PT",
"JP",
"FR",
"HU",
"SA",
"BR",
"SC",
"SG",
"ID",
"GB",
"CA",
"US",
"AE",
"CH",
"KR",
"MX",
"IT",
"MY",
"ES",
"AT",
"AU",
"TH",
"CZ",
"VN",
"PH",
"TR",
"NL"
],
"is_collection": false,
"goods_source_count": 4098,
"popular_person_count": 1,
"put_day_change": 7,
"play_change": 3062405,
"digg_change": 34776,
"latest_data": [
{
"platform": 1,
"url": "https://cdn-video.pipispy.com/cover_ada1b5dae0c90e5c4849.jpg",
"count": 855
},
{
"platform": 1,
"url": "https://cdn-video.pipispy.com/cover_52a1eb83b3133814a76b.jpg",
"count": 1122
},
{
"platform": 1,
"url": "https://cdn-video.pipispy.com/cover_fc6b7355ef13c217a26c.jpg",
"count": 973
}
]
}
],
"page": {
"total_count": 10000,
"page_count": 500,
"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 |