# 素材信息查询

> 来源：https://help.gravity-engine.com/docs/server-integration/reporting/creative-info
> 说明如何通过 Gravity Engine OpenAPI 查询媒体素材与 Gravity Engine 本地素材之间的关联关系，涵盖认证、请求参数、筛选条件和返回字段。



此接口用于查询媒体素材与引力本地素材的关联关系。

## 申请引力开发者应用 [#申请引力开发者应用]

在正式接入本接口之前，您需要在引力后台-[引力开发者](https://web.gravity-engine.com/#/manage/develop)页面申请引力开发者应用，申请之后，我们将在一个工作日内完成审核，审核通过之后，您的开发者应用才可以正常拉取数据。

创建好开发者应用之后，请复制 `app_key` 参数，并发送给研发同学以供后续接口调用使用。

## 接口信息 [#接口信息]

### 请求地址 [#请求地址]

```text
https://api-insight.gravity-engine.com/openapi/api/v1/material/id_map/
```

### 请求方法 [#请求方法]

POST

### Header [#header]

| 字段            | 类型     | 描述                                                            |
| ------------- | ------ | ------------------------------------------------------------- |
| Authorization | string | 具体如何生成，请参考 [【签名生成】](/docs/server-integration/request-signing) |

### body 参数 [#body-参数]

| 参数名                | 必填 | 类型        | 说明      | 描述                                                       |
| ------------------ | -- | --------- | ------- | -------------------------------------------------------- |
| `ad_platform`      | Y  | string    | 媒体平台    | 取值参考 [【广告平台枚举值】](/docs/appendix/ad-platform-enums)       |
| `material_id_list` | Y  | string\[] | 媒体素材 ID | 对应媒体平台的素材 ID                                             |
| `sign`             | Y  | string    | 签名      | 详情请参考 [【签名生成】](/docs/server-integration/request-signing) |

### 请求示例 [#请求示例]

```bash
curl 'https://api-insight.gravity-engine.com/openapi/api/v1/material/id_map/' \
-H 'Content-Type: application/json' \
-H 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBfa2V5IjoiYmY5YjNhZjU2ZDNkNGM5ZDkyZTFhYmNlMDYxmGQwNWQifQ.nIamPAHCSwThBAwI_cfWAcPRIjoATPvF_2i0VTEn-V0' \
-d '{
    "ad_platform": "bytedance",
    "material_id_list": ["6995736329645490187", "6994682342909165605"],
    "sign": "17aae8b72954500bc7265200023d01f1"
}'
```

### 应答示例 [#应答示例]

```json
{
    "data": {
        "6994682342909165605": 7948170452537344,
        "6995736329645490187": 7948170992553984
    },
    "extra": {
        "error": "",
        "request_id": "39a6650a78224d568ed10e9fc15bf65d"
    },
    "code": 0,
    "msg": "成功"
}
```