WeChat Channels In-Channel Video Search

API docs
https://api.sandbase.ai/v1/api/wechat-channels/v2/search-channel-videos

Search one WeChat Channels creator's videos by keyword, within that channel only. Returns matching video IDs and titles.

Price
$0.01USD / call
Method
POST
Response
JSON
Parameters
2 required · 1 optional

Playground

Input
Keyword to search within this channel (1-100 chars)
Creator finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).
Optional, default True. True=raw search response; False=simplified parsed structure.
OutputExample
Responseoutputs · 1.2 KB · 33 lines
[
  {
    "data": {
      "continue_flag": 0,
      "count": 2,
      "debug_id": "a7b55b29",
      "debug_info": "gAAAAABqxNIfvK5cfJ9V3FEUhglxoIB779ni5g2XcrzJT5yaJ1A12VV6NVzJegtQnNpGIovLPRVurFkYyFyHLXN2GmvBz1GPsxjZoz7izDUwmsAGbV70vBOv2-gzycrJXGohOv0QNhJVxJSH8WlWYogEW-Ij22xMIBd_3CQkl7MYvQvIvEmgPLONVIB907kIEbRJQoXHJNPQXLHe5Dy_rWOsnE59q_XNq4IxjyKJTZZ024OteAzwo7XipcJr9sCoJWGGwrAq3mZRdrWNbcinLaxVhtSnjG2B4w==",
      "items": [
        {
          "desc": null,
          "doc_id": "finderobjv03bpeXe0scUqXKV+shlAmntbJbnpPujnGFatrZHCTR4U=",
          "nickname": null,
          "thumb_url": null,
          "title": "很多人小时候都读过百科全书。明《永乐大典》被誉为“有史以来规模最大的百科全书”。它命运多舛,散佚四方,如今正被我们一点点找回。守护典籍,吾辈有责,望文脉不绝,国运长盛!#了不起的文物 #国庆",
          "type": "video",
          "username": null
        },
        {
          "desc": null,
          "doc_id": "finderobjv0O5SIOinYNVjnkyfj1Cauap24KvwiAQUHWfE4Msh7+t8=",
          "nickname": null,
          "thumb_url": null,
          "title": "在运河上划桨板,City 不 City?来!跟上@人民日报 记者的脚步,开启一场不一样的“北京城市副中心奇旅”。",
          "type": "video",
          "username": null
        }
      ],
      "keyword": "永乐大典",
      "next_cursor": null,
      "username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

WeChat Channels In-Channel Video Search API

This API searches the videos of one WeChat Channels creator by keyword. It needs the creator's finder username (v2_…@finder) and a keyword. It returns the matching videos with their IDs and titles.

Use cases

  • Find a specific video in a channel that has hundreds of posts.
  • Check whether a media account has covered a topic, such as a historical artifact, before you plan new content.
  • Build a topic archive by collecting the titles and IDs of all of a creator's videos on one subject.
  • Collect video IDs for one topic, then pass them to a detail or comment API.

Request

curl -X POST "https://api.sandbase.ai/v1/api/wechat-channels/v2/search-channel-videos" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder", "keyword": "永乐大典", "raw": false}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
keywordstringYesKeyword to search within this channel (1-100 chars)
usernamestringYesCreator finder username (v2_…@finder format). E.g. v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder (People's Daily).
rawbooleanNoOptional, default True. True=raw search response; False=simplified parsed structure.

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "continue_flag": 0,
  "count": 2,
  "debug_id": "02cd9d55",
  "debug_info": "gAAAAABq6ZEmEsuQBEctI0ZyuqCBcYaZ-dBcS1COMK33U2b9NCw0pykWQmxzzYcVY9z7VDsw_S4LDlOL…",
  "items": [
    {
      "desc": null,
      "doc_id": "finderobjv03bpeXe0scUqXKV+shlAmntbJbnpPujnGFatrZHCTR4U=",
      "nickname": null,
      "thumb_url": null,
      "title": "很多人小时候都读过百科全书。明《永乐大典》被誉为“有史以来规模最大的百科全书”。它命运多舛,散佚四方,如今正被我们一点点找回。守护典籍,吾辈有责,望文脉不绝,国…",
      "type": "video",
      "username": null
    }
  ],
  "keyword": "永乐大典",
  "next_cursor": null,
  "username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@…"
}

Response fields

FieldMeaning
countNumber of videos in the items list for this response.
continue_flagPaging flag. The value 0 in this response, where next_cursor is null, shows that no further results are signaled.
next_cursorCursor for the next page of results. It is null when there is no next page.
items[].doc_idID of the matching video. It starts with finderobjv0. Use it to identify the video in follow-up calls.
items[].titleVideo title or caption text, including any hashtags and @mentions.
items[].typeKind of result. The value is video for each item here.
items[].desc / items[].nickname / items[].thumb_url / items[].usernameExtra item fields. They are null in this response with raw set to false.
keyword / usernameEcho of the search keyword and the creator's finder username from the request.

Notes

Pricing

$0.01 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
WeChat Channels$0.01 per callJSON
WeChat Channels$0.01 per callJSON
WeChat Channels$0.01 per callJSON
WeChat Channels$0.01 per callJSON
WeChat Channels$0.01 per callJSON
WeChat Channels$0.01 per callJSON

Questions

FAQ

How do I use the WeChat Channels In-Channel Video Search API?

Send a POST request to https://api.sandbase.ai/v1/api/wechat-channels/v2/search-channel-videos with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the WeChat Channels In-Channel Video Search API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the WeChat Channels In-Channel Video Search API accept?

Required: keyword (string) and username (string). Optional: raw (boolean). The Parameters table and the Playground on this page list every field.

What does the WeChat Channels In-Channel Video Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a WeChat Channels developer account or API key?

No. WeChat Channels In-Channel Video Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for WeChat Channels API access separately.