weixin.item_search
公共参数
请求地址: https://api-gw-4.cn/weixin/item_search
请求参数
请求参数：q=连衣裙&
参数说明：q:关键词,没有其他参数
响应参数
Version: Date:
num_iid
title
pic_url
promotion_price
price
sales
area
seller_nick
detail_url
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/weixin/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=连衣裙&"
响应示例
异常示例
相关资料
错误码解释
API 工具
微信公众号根据关键词获取文章列表的API通常指的是微信公众平台的“素材管理”接口中的“获取素材列表”功能。通过这个接口，开发者可以获取公众号已上传的文章素材列表，包括图文消息、视频、音频等。以下是API返回值的一般说明：
### 返回值
**注：**以下返回值结构是基于微信公众平台官方文档的通用结构，具体细节和字段可能会随着平台更新而发生变化，请以最新官方文档为准。
```json
{
"errcode": 0,
"errmsg": "ok",
"total_count": 100, // 符合条件的素材总数
"item_count": 10, // 本次调用返回的素材数量
"items": [
{
"media_id": "MEDIA_ID", // 素材的media_id
"title": "TITLE", // 素材的标题
"thumb_media_id": "THUMB_MEDIA_ID", // 素材缩略图的media_id
"author": "AUTHOR", // 作者
"digest": "DIGEST", // 摘要
"show_cover_pic": 1, // 是否显示封面，0为不显示，1为显示
"content_type": "1", // 素材类型，1为图文消息，2为图片，3为视频，4为音频
"content": {
// 图文消息的具体内容，当content_type为1时返回
"news_item": [
{
"title": "TITLE",
"description": "DESCRIPTION",
"url": "URL",
"picurl": "PIC_URL"
},
// ... 其他图文消息项
]
},
"create_time": "1380000000" // 素材创建时间
},
// ... 其他素材项
]
}
```
### 返回值字段说明
- **errcode**: 错误码，0表示请求成功，非0值表示请求失败。
- **errmsg**: 错误信息，当errcode不为0时返回具体的错误信息。
- **total_count**: 符合条件的素材总数，表示当前关键词下所有符合条件的素材数量。
- **item_count**: 本次调用返回的素材数量，表示本次请求返回的文章列表中的文章数量。
- **items**: 文章列表，包含多个文章对象。
- **media_id**: 素材的唯一标识，可用于发送消息等接口。
- **title**: 素材的标题。
- **thumb_media_id**: 素材缩略图的media_id，可以用于获取缩略图链接。
- **author**: 作者。
- **digest**: 摘要或简介。
- **show_cover_pic**: 是否显示封面图片，1表示显示，0表示不显示。
- **content_type**: 素材的类型，如1为图文消息，2为图片，3为视频，4为音频。
- **content**: 具体内容，当`content_type`为1时，该字段包含图文消息的具体内容。
- **news_item**: 图文消息项列表，包含多个图文消息对象。
- **title**: 图文消息的标题。
- **description**: 图文消息的描述或摘要。
- **url**: 图文消息的链接地址。
- **picurl**: 图文消息的封面图片链接。
- **create_time**: 素材的创建时间，以Unix时间戳形式表示。
### 注意事项
1. **调用频率限制**：根据公众平台的限制，开发者调用该接口的频率可能有限制，请遵守相关规定。
2. **错误处理**：开发者在调用接口时应检查`errcode`和`errmsg`字段，以处理可能的错误情况。
3. **分页处理**：如果`item_count`小于`total_count`，则表示还有更多的素材未被返回，需要继续调用接口并传递适当的分页参数来获取剩余素材。
4. **数据更新**：公众号内的素材列表会随着时间的推移而发生变化，如文章被删除、修改等，因此获取的数据可能不是最新的。
5. **接口变更**：微信公众平台的接口和返回数据可能会随着时间进行变更或升级，开发者需要定期检查并更新自己的代码以适应新的变化。