Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Toutiao: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Сведения о статьеarticle | Получите статью или видео Toutiao по URL: заголовок, текст, обложку, число прочтений или просмотров, лайки, комментарии, репосты и верификацию автора. | $0.56 за 1 000 запросов | Норма |
Профилиprofile | Получите никнейм, описание профиля, аватар, ссылку на профиль, а также статус верификации аккаунта Toutiao и описание этого статуса. | $0.56 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите список статей, видео и коротких постов автора Toutiao: заголовок, текст, прочтения или просмотры, лайки, комментарии, репосты и время публикации. | $0.56 за 1 000 запросов | Норма |
Поиск профилейprofile_search | Ищите по ключевому слову в постах одного аккаунта Toutiao: подходящие статьи и видео с текстом, числом прочтений или просмотров и показателями вовлечённости. | $0.56 за 1 000 запросов | Норма |
Комментарииcomments | Получите комментарии верхнего уровня к статье или видео Toutiao, по 20 на страницу. | $0.81 за 1 000 запросов | Норма |
Сведения о видеоvideo | Найдите одно видео Toutiao по ссылке или числовому ID: название, длительность, просмотры, лайки, комментарии, репосты, сохранения, время публикации, обложку, подписанную ссылку на видеофайл и имя автора. | $0.81 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Toutiao?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
articleСведения о статье Получите статью или видео Toutiao по URL: заголовок, текст, обложку, число прочтений или просмотров, лайки, комментарии, репосты и верификацию автора. Полный текст или расшифровка появляются, только если они есть на странице. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profileПрофили Получите никнейм, описание профиля, аватар, ссылку на профиль, а также статус верификации аккаунта Toutiao и описание этого статуса. | user_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | user_id · nickname · bio · url · avatar_url · is_verified · verify_reason · platform |
user_postsПосты пользователя Получите список статей, видео и коротких постов автора Toutiao: заголовок, текст, прочтения или просмотры, лайки, комментарии, репосты и время публикации. Раздел профиля выбирается через | user_id | tab | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
profile_searchПоиск профилей Ищите по ключевому слову в постах одного аккаунта Toutiao: подходящие статьи и видео с текстом, числом прочтений или просмотров и показателями вовлечённости. Оба параметра, | user_id, keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · type · title · text · content_text · cover · read_count · play_count · like_count · comment_count · share_count · source · author_name · author_id · author_verified · author_auth_info · region · posted_at · platform · duration_sec · duration_seconds · image_urls |
commentsКомментарии Получите комментарии верхнего уровня к статье или видео Toutiao, по 20 на страницу. У каждого комментария есть текст, лайки, число ответов, время, имя, аватар, верификация и регион IP комментатора, а также признак того, лайкнул ли его автор. Передайте ссылку на статью или видео либо числовой ID и переходите по страницам с | url | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · text · like_count · reply_count · posted_at · author_id · author_name · author_avatar_url · author_verified · author_auth_info · ip_location · liked_by_author · platform |
videoСведения о видео Найдите одно видео Toutiao по ссылке или числовому ID: название, длительность, просмотры, лайки, комментарии, репосты, сохранения, время публикации, обложку, подписанную ссылку на видеофайл и имя автора. Для горизонтальных видео добавляются показы, токен профиля автора и число подписчиков. Вертикальные короткие видео тоже поддерживаются. | url | — | Режим выдачи: Sync | — | $0.81 за 1 000 запросов | id · url · video_type · title · duration_sec · duration_seconds · play_count · like_count · comment_count · share_count · collect_count · impression_count · posted_at · cover_url · video_url · author_id · author_name · author_avatar_url · author_follower_count · author_verified · author_auth_info · platform |
Что означают параметры действия article в API Toutiao?
Получите статью или видео Toutiao по URL: заголовок, текст, обложку, число прочтений или просмотров, лайки, комментарии, репосты и верификацию автора. Полный текст или расшифровка появляются, только если они есть на странице.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Полный URL конкретной статьи или видео для действия
article. Если в действиях для пользователя переданы иurl, иuser_id, для определения страницы профиля приоритет имеетurl.
Что означают параметры действия profile в API Toutiao?
Получите никнейм, описание профиля, аватар, ссылку на профиль, а также статус верификации аккаунта Toutiao и описание этого статуса. user_id принимает токен аккаунта, обычно начинающийся с MS4w, или полный URL профиля, а не никнейм или короткий числовой ID.
user_idОбязательный- Токен профиля пользователя или
secUid, обычно начинается сMS4w. В этом поле можно также передать полный URL профиля Toutiao. Отображаемые никнеймы и короткие числовые UID не принимаются.
Что означают параметры действия user_posts в API Toutiao?
Получите список статей, видео и коротких постов автора Toutiao: заголовок, текст, прочтения или просмотры, лайки, комментарии, репосты и время публикации. Раздел профиля выбирается через tab. Один пакет может не охватывать весь архив.
user_idОбязательный- Токен профиля пользователя или
secUid, обычно начинается сMS4w. В этом поле можно также передать полный URL профиля Toutiao. Отображаемые никнеймы и короткие числовые UID не принимаются. tabНеобязательный- Выбирает вкладку ленты профиля в
user_posts. Допустимые значения:all(по умолчанию),article,video,ugcиshort_video. Не меняет типы записей в детальных данных.Toutiao: Micro-Toutiao и статьи — разные типы контента — Справочный центр для авторов Toutiao описывает Micro-Toutiao как короткий контент для соцсетей и отдельно рассказывает о процессах его публикации и редактирования. Этот API читает посты в соответствии с описанием столбцов выше; ссылка на эти процессы не даёт ему возможности публиковать, редактировать, участвовать в темах или получать доход автора. · Проверено
Что означают параметры действия profile_search в API Toutiao?
Ищите по ключевому слову в постах одного аккаунта Toutiao: подходящие статьи и видео с текстом, числом прочтений или просмотров и показателями вовлечённости. Оба параметра, user_id и keyword, обязательны. Поиск людей и поиск по всей платформе не выполняются.
user_idОбязательный- Токен профиля пользователя или
secUid, обычно начинается сMS4w. В этом поле можно также передать полный URL профиля Toutiao. Отображаемые никнеймы и короткие числовые UID не принимаются. keywordОбязательный- Поисковый запрос по постам только внутри профиля, заданного
user_id, вprofile_search. Поиск по всему Toutiao не выполняется.
Что означают параметры действия comments в API Toutiao?
Получите комментарии верхнего уровня к статье или видео Toutiao, по 20 на страницу. У каждого комментария есть текст, лайки, число ответов, время, имя, аватар, верификация и регион IP комментатора, а также признак того, лайкнул ли его автор. Передайте ссылку на статью или видео либо числовой ID и переходите по страницам с next_page_token. Сами ответы не возвращаются; их число показывает reply_count.
urlОбязательный- Ссылка на статью или видео Toutiao (https://www.toutiao.com/article/<ID>/ или https://www.toutiao.com/video/<ID>/; старые ссылки /i<ID>/, /a<ID>/ и /item/<ID>/ тоже подходят) или числовой ID из неё. Каждый вызов возвращает одну страницу, содержащую до 20 комментариев верхнего уровня.
page_tokenНеобязательный- Токен страницы для
comments: чтобы получить следующую страницу, передайтеnext_page_tokenиз предыдущего ответа; чтобы начать с первой, не передавайте его.urlдолжен совпадать с вызовом, который вернул токен. Токены действуют 24 часа; для каждой страницы нужен отдельный вызов.
Что означают параметры действия video в API Toutiao?
Найдите одно видео Toutiao по ссылке или числовому ID: название, длительность, просмотры, лайки, комментарии, репосты, сохранения, время публикации, обложку, подписанную ссылку на видеофайл и имя автора. Для горизонтальных видео добавляются показы, токен профиля автора и число подписчиков. Вертикальные короткие видео тоже поддерживаются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на видео Toutiao (https://www.toutiao.com/video/<ID>/; ссылки /item/<ID>/ и /group/<ID>/ тоже подходят) или числовой ID из неё. ID статьи возвращает пустой результат.
Как использовать API Toutiao
- 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":"toutiao","action":"article","params":{"url":"<url>"}}'
Вопросы об API Toutiao
Какие данные можно получить через API Toutiao?
Укажите в platform значение toutiao. В текущем каталоге: сведения о статье, профили, посты пользователя, поиск профилей, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям Toutiao; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса article к платформе Toutiao?
Полный URL конкретной статьи или видео для действия article. Если в действиях для пользователя переданы и url, и user_id, для определения страницы профиля приоритет имеет url. Передайте это значение в поле url объекта params.
Какие поля может вернуть article на платформе Toutiao?
Объявленная схема включает type, title, text и content_text. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Toutiao возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.