微信公众号：如何根据关键词取文章列表 API 返回值说明？

item_search-根据关键词取文章列表

weixin.item_search

公共参数

请求地址: https://api-gw-4.cn/weixin/item_search

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：q=连衣裙&

参数说明：q:关键词,没有其他参数

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	String	0	2283003	商品ID
title	String	0	MOCO夏季新品高腰牛仔斜裁蕾丝拼接半身裙MA182SKT402 摩安珂	商品标题
pic_url	String	0	http://pop.nosdn.127.net/184e3b95-f1f8-4fb8-a1c4-c3533b4ad618	商品图片
promotion_price	Int	0	1099	参考价
price	Float	0	549	价格
sales	Int	0	3	销量
area	String	0	中国	店铺所在地
seller_nick	String	0	MO&Co.官方旗舰店	卖家昵称
detail_url	String	0	https://goods.kaola.com/product/2283003.html	商品链接

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/weixin/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=连衣裙&"

响应示例

异常示例

相关资料

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否

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. **接口变更**：微信公众平台的接口和返回数据可能会随着时间进行变更或升级，开发者需要定期检查并更新自己的代码以适应新的变化。

确保在实际开发中查阅最新的微信公众平台官方文档，以获取最准确的信息和接口使用指南。