Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API iQIYI Поиск

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Ищите шоу и видео iQIYI по ключевому слову с фильтрами по категории, периоду публикации, качеству, сайту-источнику или сортировке; в результатах есть длительность, индекс популярности, рейтинг, сериал и актёры. heat_count — собственный показатель популярности iQIYI, а не число просмотров, и его нельзя сравнивать между платформами.

iQIYI Search ищет видео на iQIYI по keyword и возвращает для каждого результата название, описание, категорию, длительность, индекс популярности, рейтинг, лайки, комментарии и сохранения, а также сериал, к которому относится видео, постеры, cast и данные пользователя, загрузившего видео. Используйте эту возможность, чтобы узнать, какие фильмы, сериалы, шоу и клипы есть по названию или теме и как их принимают зрители: для исследований при лицензировании контента, анализа развлекательного рынка или отслеживания шоу на iQIYI.

Фильтруйте результаты по category, например movie, tv_series или variety_shows, ограничивайте период с помощью publish_date и задавайте порядок через sort. iQIYI называет сериал альбомом, а каждый эпизод — видео, поэтому названия относящихся к сериалу полей начинаются с album. heat_count — собственный индекс популярности iQIYI, а не число просмотров, и сравнивать его между платформами нельзя. rating указан по 10-балльной шкале; прежде чем сравнивать его с сайтами с пятизвёздочной шкалой, проверьте rating_scale в записи.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra iQIYI Поиск (iqiyi/search).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: iqiyi и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Поисковый запрос для действия search либо названия сериалов и альбомов или имена актёров для международного действия album.
- Необязательные параметры:
  - category: Фильтрует видео по категории. Допустимые значения: movie, tv_series, variety_shows, animation, documentary, advertisement, beauty, car, comedy, entertainment, fashion, finance, game, health, life, military, mother_baby,… (допустимые значения: advertisement / all / animation / beauty / car / comedy / documentary / entertainment)
  - publish_date: Фильтрует результаты действия search по периоду публикации: all, last_24_hours, last_7_days или last_30_days. Даты в формате YYYY-MM-DD не принимаются; если переданы и этот параметр, и published, приоритет у published.
  - published: Переопределяет publish_date в действии search; принимает all, last_24_hours, last_7_days или last_30_days. Это строковый фильтр, логические значения true/false не принимаются.
  - quality: Фильтрует результаты поиска iQIYI по качеству видео. Распространённые значения: all, hd, ultra_hd, 720p и 1080p. Это не параметр скачивания или перекодирования; значения не из списка могут не сработать.
  - scrape_additional_info: Определяет, включать ли в результаты поиска iQIYI дополнительные данные об авторе и вовлечённости. Передайте логическое значение JSON; по умолчанию используется true.
  - site: Задаёт условие по сайту-источнику для поиска. Распространённые значения: all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv и m1905.
  - sort: Задаёт порядок результатов поиска видео: relevance, newest или popular. Не сортирует по оценкам пользователей или порядку выхода серий и не влияет на запрос одного видео. (допустимые значения: newest / popular / relevance)
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, title, text, category, category_id, duration_seconds, duration_sec, heat_count, rating, rating_scale, rating_count; всего полей: 30, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi.
- Пример тела запроса:
{
  "platform": "iqiyi",
  "action": "search",
  "params": {
    "keyword": "纪录片"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаiqiyiИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Поисковый запрос для действия search либо названия сериалов и альбомов или имена актёров для международного действия album. Действие album не получает данные напрямую по URL альбомов, а доступные каталоги зависят от региона.
categorybody.paramsstring (enum)Нет-Фильтрует видео по категории. Допустимые значения: movie, tv_series, variety_shows, animation, documentary, advertisement, beauty, car, comedy, entertainment, fashion, finance, game, health, life, military, mother_baby, music, news_info, originals, short_films, sports, square_dance, talk_shows, technology, trailers, travel, trending или all (без ограничений). Параметр фильтрует по общим категориям, а не по тегам актёров или сериалов.Допустимые значенияadvertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows
publish_datebody.paramsstringНет-Фильтрует результаты действия search по периоду публикации: all, last_24_hours, last_7_days или last_30_days. Даты в формате YYYY-MM-DD не принимаются; если переданы и этот параметр, и published, приоритет у published.
publishedbody.paramsstringНет-Переопределяет publish_date в действии search; принимает all, last_24_hours, last_7_days или last_30_days. Это строковый фильтр, логические значения true/false не принимаются.
qualitybody.paramsstringНет-Фильтрует результаты поиска iQIYI по качеству видео. Распространённые значения: all, hd, ultra_hd, 720p и 1080p. Это не параметр скачивания или перекодирования; значения не из списка могут не сработать.
scrape_additional_infobody.paramsbooleanНет-Определяет, включать ли в результаты поиска iQIYI дополнительные данные об авторе и вовлечённости. Передайте логическое значение JSON; по умолчанию используется true. Значение false отключает этот дополнительный запрос, но не меняет стоимость API EveryInfra.
sitebody.paramsstringНет-Задаёт условие по сайту-источнику для поиска. Распространённые значения: all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv и m1905. Параметр сужает результаты поиска до этих сайтов и не означает, что для каждого сайта есть действие получения подробной информации.
sortbody.paramsstring (enum)Нет-Задаёт порядок результатов поиска видео: relevance, newest или popular. Не сортирует по оценкам пользователей или порядку выхода серий и не влияет на запрос одного видео.Допустимые значенияnewestpopularrelevance
limitbody.paramsinteger (1–50)Нет20Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "iqiyi",
  "action": "search",
  "params": {
    "keyword": "纪录片"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "iqiyi",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://qy.net/63KmTun-1f",
      "title": "大黄蜂捕食蜜蜂,实力碾压 #好奇昆虫 #动物世界 #纪录片",
      "category": "纪录片",
      "category_id": 3,
      "duration_seconds": 82,
      "heat_count": 123,
      "like_count": 0,
      "comment_count": 0,
      "collect_count": 0,
      "image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_120_160.jpg",
      "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_480_270.jpg",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://img7.iqiyipic.com/•••",
      "author_follower_count": 529,
      "author_video_count": 52,
      "author_location": "河南",
      "author_org": "漯河市郾城区芝芝文化传媒工作室(个体工商户)",
      "posted_at": "2026-10-24T15:30:00+00:00",
      "platform": "iqiyi",
      "duration_sec": 82
    },
    {
      "id": "•••",
      "url": "https://qy.net/f6KjGub-7c",
      "title": "听说过日本姓氏奇葩,没想到这么奇葩 #搞笑 #大型纪录片 ",
      "category": "搞笑",
      "category_id": 22,
      "duration_seconds": 98,
      "heat_count": 7,
      "like_count": 0,
      "comment_count": 0,
      "collect_count": 0,
      "image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_120_160.jpg",
      "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_480_270.jpg",
      "author_name": "•••",
      "author_id": "•••",
      "author_avatar_url": "https://img7.iqiyipic.com/•••",
      "author_follower_count": 217,
      "author_video_count": 156,
      "author_location": "河南",
      "author_org": "漯河市郾城区芝芝文化传媒工作室(个体工商户)",
      "posted_at": "2026-10-24T10:40:00+00:00",
      "platform": "iqiyi",
      "duration_sec": 98
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
category_idТрактуется так же, как на самой платформе
duration_secondsДлительность в секундах. null для контента, который не является видео или аудио.
duration_secТрактуется так же, как на самой платформе
heat_countТрактуется так же, как на самой платформе
ratingРейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным.
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.
rating_countКоличество оценивших. null означает, что значение не раскрыто, а не 0.
like_countЛайки. null означает, что платформа или эта возможность не раскрывает значение; это не 0.
comment_countКомментарии. null означает, что значение не раскрыто, а не 0.
collect_countСохранения или добавления в избранное. null означает, что значение не раскрыто, а не 0.
album_idТрактуется так же, как на самой платформе
album_titleТрактуется так же, как на самой платформе
album_urlТрактуется так же, как на самой платформе
album_episode_countТрактуется так же, как на самой платформе
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
wide_image_urlТрактуется так же, как на самой платформе
author_nameОтображаемое имя автора.
author_idУникальный ID автора на платформе.
author_avatar_urlТрактуется так же, как на самой платформе
author_follower_countЧисло подписчиков автора. null означает, что значение не раскрыто.
author_video_countТрактуется так же, как на самой платформе
author_locationТрактуется так же, как на самой платформе
author_orgТрактуется так же, как на самой платформе
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
castТрактуется так же, как на самой платформе

FAQ

heat_count — это число просмотров?

Нет. Это собственный индекс популярности iQIYI, метрика платформы, а не число воспроизведений, поэтому сопоставлять с ним цифры других платформ нельзя. Используйте его для ранжирования результатов внутри iQIYI и смотрите на него вместе с rating и rating_count, когда оцениваете, как зрители принимают тайтл.

Как оставить только фильмы или сериалы?

Задайте для category значение movie или tv_series; так же работают variety_shows, animation и documentary, а all снимает фильтр. category обозначает тип контента, а не тег актёрского состава или сериала. Чтобы получить недавние загрузки, укажите в published или publish_date период, например last_7_days; если переданы оба параметра, приоритет у published, и ни один из них не принимает календарную дату.

Как сгруппировать серии одного сериала?

iQIYI хранит каждый эпизод как видео в составе сериала, который платформа называет альбомом. У записей одного сериала совпадают album_id и album_title, album_episode_count содержит общее число эпизодов, а album_url ведёт на страницу сериала, поэтому показатели отдельных эпизодов можно агрегировать для всего шоу.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • iQIYI: чем индекс популярности контента отличается от числа воспроизведений на сайте ↗

    В анонсе iQIYI 2018 года индекс популярности контента описан как составная метрика, которая учитывает просмотры, взаимодействия и репосты и отличается от числа воспроизведений. Это лишь поясняет тип метрики heat_count: отсюда нельзя выводить текущие алгоритмы, пороги или сопоставимость между платформами, а также вычислять реальное число воспроизведений по индексу популярности.

    Проверено 2026-09-04