keywordstringrequired
Keyword to search within this channel (1-100 chars)
https://api.sandbase.ai/v1/api/wechat-channels/v2/search-channel-videosSearch one WeChat Channels creator's videos by keyword, within that channel only. Returns matching video IDs and titles.
[
{
"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"
}
}
]Select an example to load its inputs and result into the playground.
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.
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.
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword to search within this channel (1-100 chars) |
username | string | Yes | Creator finder username (v2_…@finder format). E.g. v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder (People's Daily). |
raw | boolean | No | Optional, default True. True=raw search response; False=simplified parsed structure. |
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@…"
}
| Field | Meaning |
|---|---|
count | Number of videos in the items list for this response. |
continue_flag | Paging flag. The value 0 in this response, where next_cursor is null, shows that no further results are signaled. |
next_cursor | Cursor for the next page of results. It is null when there is no next page. |
items[].doc_id | ID of the matching video. It starts with finderobjv0. Use it to identify the video in follow-up calls. |
items[].title | Video title or caption text, including any hashtags and @mentions. |
items[].type | Kind of result. The value is video for each item here. |
items[].desc / items[].nickname / items[].thumb_url / items[].username | Extra item fields. They are null in this response with raw set to false. |
keyword / username | Echo of the search keyword and the creator's finder username from the request. |
username value with WeChat Channels ID to Username if you only have a public Channel ID (sph… short ID).raw to false for the simplified structure shown here. The default is true, which returns the raw search response.doc_id to WeChat Channels Video Detail to look up one video in full.$0.01 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-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" \
--data-binary @- <<'SANDBASE_JSON'
{
"keyword": "永乐大典",
"username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder",
"raw": false
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
keywordstringrequiredKeyword to search within this channel (1-100 chars)
usernamestringrequiredCreator finder username (`v2_…@finder` format). E.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily).
rawbooleanOptional, default True. True=raw search response; False=simplified parsed structure.
Saved example response for this API; no live request is made when viewing it.
[
{
"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"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
WeChat Channels | $0.01 per call | JSON |
WeChat Channels | $0.01 per call | JSON |
WeChat Channels | $0.01 per call | JSON |
WeChat Channels | $0.01 per call | JSON |
WeChat Channels | $0.01 per call | JSON |
WeChat Channels | $0.01 per call | JSON |
Questions
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.
$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: keyword (string) and username (string). Optional: raw (boolean). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
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.