# 广告主详情接口

## 接口信息

- **接口名称**: 获取广告主详情
- **请求方法**: POST
- **接口地址**: `/open-api/v1/data`
- **接口路径**: `/v3/api/open/advertiser/detail`
- **接口描述**: 根据广告主 ID 获取广告主详细信息

**请求头:**

- Content-Type: application/json
- Accept: application/json

## 请求参数

### 请求结构

| 参数名 | 类型   | 描述                        | 示例                             | 必填 | 默认值 |
| ------ | ------ | --------------------------- | -------------------------------- | ---- | ------ |
| key    | string | 用户申请的外部 api 请求 key | "your_api_key_here"              | 是   |        |
| uri    | string | 接口路径                    | "/v3/api/open/advertiser/detail" | 是   |        |
| params | object | 接口入参对象                | 见参数列表                       | 是   |        |

### 参数列表 (params 对象)

| 参数名 | 类型   | 必填 | 描述              |
| ------ | ------ | ---- | ----------------- |
| id     | String | 是   | 广告主唯一标识 ID |

### 请求示例

```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/advertiser/detail",
    "params": {
      "id": "66f994b3a8f1cc723674b9ff"
    }
  }'
```

## 响应参数

### 响应体结构

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

### 响应字段说明

| 字段名    | 类型        | 描述                          |
| --------- | ----------- | ----------------------------- |
| code      | Integer     | 响应状态码，200 表示成功      |
| message   | String      | 响应消息                      |
| data      | Object      | 广告主详情信息                |
| version   | String      | API 版本                      |
| timestamp | Number/null | 响应时间戳（不可用时为 null） |
| sign      | String/null | 响应签名（不可用时为 null）   |
| remaining_credits | Long    | 当前请求后的剩余可用积分 |
| consumed_credits  | Long    | 本次请求消耗的积分 |
| success   | Boolean     | 请求是否成功                  |
| fail      | Boolean     | 请求是否失败                  |

### 广告主详情字段

| 字段名            | 类型    | 描述                             |
| ----------------- | ------- | -------------------------------- |
| id                | String  | 广告主唯一标识 ID                |
| root_path         | String  | 广告主（域名）                      |
| app_image         | String  | 应用图片 URL                     |
| ad_platform_list  | Array   | 广告平台列表（tiktok, facebook 等） |
| shop_type         | Array   | 商店类型列表                     |
| data_count        | Number  | 数据总数                         |
| monthly_visits    | Number  | 月访问量                         |
| first_data_time   | Number  | 首次数据时间（时间戳）              |
| found_time        | Number  | 发现时间（时间戳）                 |
| latest_found_time | Number  | 最新发现时间（时间戳）              |
| region            | Array   | 地区列表                         |
| is_collection     | Boolean | 是否已收藏                       |

## 响应示例

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "id": "655f4a07a1b892646643349e",
    "region": [
      "DE",
      "TW",
      "PT",
      "DK",
      "LT",
      "LU",
      "LV",
      "HR",
      "UA",
      "HU",
      "LY",
      "MA",
      "MF",
      "YT",
      "ID",
      "IE",
      "US",
      "EE",
      "MQ",
      "IN",
      "MT",
      "IT",
      "MX",
      "ES",
      "AT",
      "RE",
      "AU",
      "VN",
      "RO",
      "NL",
      "BD",
      "BE",
      "FI",
      "BG",
      "JP",
      "FR",
      "SA",
      "SE",
      "SG",
      "SI",
      "SK",
      "GB",
      "KH",
      "CA",
      "GF",
      "GP",
      "GR",
      "CN",
      "TH",
      "LA",
      "CY",
      "CZ",
      "PL"
    ],
    "root_path": "donotage.org",
    "app_image": "https://fb-cdn.pipispy.com/images/cb28fc3f16e9711e247b575ca4fb43b6.png",
    "ad_platform_list": ["tiktok", "facebook"],
    "shop_type": ["magento"],
    "data_count": 368,
    "monthly_visits": 243818,
    "first_data_time": 1675830644,
    "found_time": 1675830644,
    "latest_found_time": 1752202412,
    "is_collection": false
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}
```

## 错误码说明

| 错误码 | 描述                          |
| ------ | ----------------------------- |
| 200    | 成功                          |
| 400    | 请求参数错误，如缺少广告主 ID |
| 404    | 广告主不存在                  |
| 500    | 服务器内部错误                |