# App Developer Detail API

## API Information

- **API Name**: Get App Developer Detail
- **Request Method**: POST
- **API URL**: `/open-api/v1/data`
- **Interface URI path**: `/v3/api/open/app-dev/detail`
- **Description**: Get detailed information of app developer by developer 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-dev/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 developer ID | "507f1f77bcf86cd799439011" | Yes      |         |

### Request Example

```bash
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/detail",
    "params": {
      "id": "507f1f77bcf86cd799439011"
    }
  }'
```

## Response Parameters

### Response Body Structure

```json
{
  "code": 200,
  "message": "success",
  "data": {
    // App developer detail information
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}
```

### 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                          |
| ----------------------------- | ------- | ------------------------------------ |
| id                            | string  | App developer unique identifier ID   |
| icon                          | string  | App developer icon URL               |
| name                          | string  | App developer name                   |
| url                           | string  | App developer store URL              |
| ad_platform_list              | array   | Advertising platform list            |
| app_system                    | array   | App system list (e.g., android, ios) |
| all_data_count                | long    | Total data count                     |
| app_count                     | long    | App count                            |
| app_download_count            | long    | Total app download count             |
| app_comment_count             | long    | Total app comment count              |
| revenue                       | object  | Revenue information object           |
| first_time                    | long    | First time (timestamp)               |
| found_time                    | long    | First found time (timestamp)         |
| latest_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            |

##### Revenue Object Fields

| Field Name | Type   | Description                     |
| ---------- | ------ | ------------------------------- |
| unit       | string | Revenue unit (e.g., "cent")     |
| currency   | string | Currency code (e.g., "USD")     |
| type       | string | Revenue type (e.g., "currency") |
| value      | long   | Revenue value                   |

### Response Example

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "id": "7318974570271626660",
    "icon": "https://cdn-app.pipispy.com/0b6854aa841473b2657939f3221880f0.jpg",
    "name": "Knowunity",
    "url": "https://play.google.com/store/apps/dev?id=7318974570271626660",
    "ad_platform_list": ["tiktok"],
    "app_system": ["android"],
    "all_data_count": 95,
    "app_count": 1,
    "app_download_count": 13506812,
    "app_comment_count": 0,
    "revenue": {
      "unit": "cent",
      "currency": "USD",
      "type": "currency",
      "value": 4000000
    },
    "first_time": 1623380257,
    "found_time": 1623380257,
    "latest_found_time": 1752198253,
    "last_month_app_download_count": 500000,
    "region": [
      "DE",
      "PT",
      "IT",
      "GR",
      "MX",
      "FR",
      "ES",
      "BR",
      "CZ",
      "GB",
      "PL",
      "RO",
      "US",
      "TR"
    ],
    "is_collection": false
  },
  "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 developer not found |
| 500        | Internal Server Error               |