API WeChat Channels
WeChat Channels — лента коротких видео внутри WeChat. search находит видео по ключевому слову, user_posts возвращает последние видео аккаунта, video возвращает данные видео по его числовому идентификатору, а profile — публичные данные аккаунта.
Связывайте user_posts и video через идентификаторы в их записях: id служит значением object_id для video, а author_username (v2_...@finder) — значением username для user_posts. В записях поиска нет ни одного из этих идентификаторов, поэтому результат поиска нельзя открыть через video или user_posts. Ссылки на видеофайлы действуют около суток, а начало каждого файла зашифровано; расшифровать его можно с помощью video_decode_key.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия WeChat Channels: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите видео WeChat Channels по keyword и получайте одну страницу примерно из 10 результатов с названием, обложкой, длительностью, лайками, временем публикации, а также именем, аватаром и признаком верификации автора. | $60 за 1 000 запросов | Норма |
Сведения о видеоvideo | Получите одно видео WeChat Channels по object_id: числовому ID из записей user_posts или ссылке «Поделиться» на видео (https://weixin.qq.com/sph/…). | $6.81 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите последние 15 видео аккаунта WeChat Channels по его username (ID вида v2_...@finder). | $46 за 1 000 запросов | Норма |
Профилиprofile | Найдите аккаунт WeChat Channels по ID вида v2_...@finder. | $8 за 1 000 запросов | Норма |
Комментарииcomments | Читайте комментарии верхнего уровня к видео WeChat Channels по числовому ID или ссылке «Поделиться», до 25 на странице. | $8 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API WeChat Channels?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите видео WeChat Channels по | keyword | — | Режим выдачи: Sync | — | $60 за 1 000 запросов | search_rank · title · cover_url · duration_sec · duration_seconds · posted_at · like_count · author_name · author_avatar_url · author_is_verified · platform |
videoСведения о видео Получите одно видео WeChat Channels по | object_id | — | Режим выдачи: Sync | — | $6.81 за 1 000 запросов | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
user_postsПосты пользователя Получите последние 15 видео аккаунта WeChat Channels по его | username | — | Режим выдачи: Sync | — | $46 за 1 000 запросов | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
profileПрофили Найдите аккаунт WeChat Channels по ID вида v2_...@finder. Получите отображаемое имя, био, аватар, регион, число видео и подборок, часы прямых эфиров, пометку о верификации и связанные аккаунты WeChat, например официальный аккаунт. Профили Channels обычно скрывают число подписчиков, поэтому | username | — | Режим выдачи: Sync | — | $8 за 1 000 запросов | username · display_name · bio · avatar_url · region · follower_count · post_count · collection_count · live_duration_hours · verified_reason · linked_accounts · platform |
commentsКомментарии Читайте комментарии верхнего уровня к видео WeChat Channels по числовому ID или ссылке «Поделиться», до 25 на странице. Для каждого комментария возвращаются текст, лайки, время, IP-регион, имя и аватар комментатора, а также ID его аккаунта Channels, если он есть. Для следующих страниц используйте next_page_token. | object_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 25. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $8 за 1 000 запросов | id · text · like_count · posted_at · author_username · author_name · author_avatar_url · ip_location · next_page_token · platform |
Что означают параметры действия search в API WeChat Channels?
Ищите видео WeChat Channels по keyword и получайте одну страницу примерно из 10 результатов с названием, обложкой, длительностью, лайками, временем публикации, а также именем, аватаром и признаком верификации автора. В результатах поиска нет ID видео и ID аккаунта, поэтому их нельзя передать в video или user_posts.
keywordОбязательный- Поисковый запрос WeChat Channels для
search, напримерcoffee; запросы на китайском обычно находят больше видео. Один вызов возвращает одну страницу примерно из 10 видео.
Что означают параметры действия video в API WeChat Channels?
Получите одно видео WeChat Channels по object_id: числовому ID из записей user_posts или ссылке «Поделиться» на видео (https://weixin.qq.com/sph/…). Вы получите название, описание, автора, время публикации, число лайков, сохранений, репостов и комментариев, длительность, размер кадра, обложку и временную ссылку на видеофайл с ключом расшифровки. При запросе по ссылке «Поделиться» title, video_width и video_height могут отсутствовать, а description содержит полный текст поста. Выше 10 000 значения like_count и collect_count точны только до сотен и всегда оканчиваются на 02, а начиная со 100 000 всегда равны 100002; share_count точен, а comment_count выше 10 000 иногда указывается только до сотен с окончанием на 02, в остальных случаях он точен. Ссылка на файл действует около суток.
object_idОбязательный- Числовой ID одного видео WeChat Channels для
video, например15039881603147501275, из поляidзаписиuser_postsилиvideo, либо ссылка «Поделиться» на видео (https://weixin.qq.com/sph/...). В записях поиска нет ни того, ни другого. Другие форматы отклоняются до списания средств.Документация WeChat Open: feedId — уникальный ID видео в Channels — В документации WeChat для разработчиков сказано, что мини-программа открывает видео в Channels по его feedId, который автор копирует в помощнике Channels. Источник подтверждает только, что у каждого видео в Channels есть свой уникальный ID; object_id в этом API имеет другой, чисто числовой формат, берётся из записей user_posts или video и не взаимозаменяем с feedId. · Проверено
Что означают параметры действия user_posts в API WeChat Channels?
Получите последние 15 видео аккаунта WeChat Channels по его username (ID вида v2_...@finder). Для каждого видео возвращаются ID, название, описание, время публикации, число лайков, сохранений, репостов и комментариев, длительность, размер кадра, обложка и временная ссылка на видеофайл с ключом для его расшифровки. ID аккаунта не совпадает с никнеймом.
usernameОбязательный- ID аккаунта WeChat Channels для
user_postsв форматеv2_...@finderиз поляauthor_usernameзаписиuser_postsилиvideo, либо ID канала, начинающийся сsphи показанный на странице канала, напримерsphi9BjV8GK0Zsl. Это не никнейм, и в записях поиска этого ID нет. Другие форматы отклоняются до списания средств.Документация WeChat Open: ID аккаунта Channels (finderUserName) — В документации WeChat для разработчиков сказано, что finderUserName — это ID аккаунта Channels, который автор видит на главной странице помощника Channels. Источник подтверждает только, что у аккаунта Channels есть ID, отдельный от никнейма; username в этом API — это ID аккаунта вида v2_...@finder, взятый из записей user_posts или video, и он не взаимозаменяем с ID на той главной странице. · Проверено
Что означают параметры действия profile в API WeChat Channels?
Найдите аккаунт WeChat Channels по ID вида v2_...@finder. Получите отображаемое имя, био, аватар, регион, число видео и подборок, часы прямых эфиров, пометку о верификации и связанные аккаунты WeChat, например официальный аккаунт. Профили Channels обычно скрывают число подписчиков, поэтому follower_count часто отсутствует; суммарные числа лайков, добавлений в избранное и репостов не предоставляются.
usernameОбязательный- ID аккаунта WeChat Channels для
profileв форматеv2_...@finderиз поляauthor_usernameзаписиuser_postsилиvideo, либо ID канала, который начинается сsphи указан на странице канала, напримерsphi9BjV8GK0Zsl. Это не никнейм, и в записях поиска этого ID нет.
Что означают параметры действия comments в API WeChat Channels?
Читайте комментарии верхнего уровня к видео WeChat Channels по числовому ID или ссылке «Поделиться», до 25 на странице. Для каждого комментария возвращаются текст, лайки, время, IP-регион, имя и аватар комментатора, а также ID его аккаунта Channels, если он есть. Для следующих страниц используйте next_page_token.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеobject_idОбязательный- Числовой ID видео WeChat Channels, комментарии к которому нужно получить, например
15039881603147501275, из поляidзаписиuser_postsилиvideo, либо ссылка «Поделиться» на видео (https://weixin.qq.com/sph/...). page_tokenНеобязательный- Токен страницы для
comments. Для первой страницы не указывайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, для того же видео. Каждая страница — это один вызов; у последней страницы нетnext_page_token.
Как использовать API WeChat Channels
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"wechat_channels","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API WeChat Channels
Какие данные можно получить через API WeChat Channels?
Укажите в platform значение wechat_channels. В текущем каталоге: поиск, сведения о видео, посты пользователя, профили и комментарии. Эти названия действий соответствуют разным объектам или представлениям WeChat Channels; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе WeChat Channels?
Поисковый запрос WeChat Channels для search, например coffee; запросы на китайском обычно находят больше видео. Один вызов возвращает одну страницу примерно из 10 видео. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе WeChat Channels?
Объявленная схема включает search_rank, title, cover_url и duration_sec. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия WeChat Channels возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.