iQIYI Search API

POST

API health

24h health
Normal
24h average time
—
Last checked
September 26, 2026 at 18:05 (UTC)
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Health APINormal
How health is measured
  • Health = the share of calls that returned data, in percent. Empty results, failures and unknown outcomes do not count as returning data.
  • Levels: 90% and above is healthy, 70% and above is available, 40% and above is limited; anything lower is mostly down.
  • A period (the last 24 hours, one hour or one day) gets a score only once it has at least 50 calls. Periods with fewer calls show as normal: a few failures among a handful of calls do not mean the API is down.
  • Calls include real customer calls and our own daily probe calls. Request errors (wrong parameters, no balance) are excluded.
  • Average time counts only calls that completed normally: response time for sync calls, acceptance to completion for async ones.
By period
Time (UTC)StatusHealthAverage time
2026-09-26 18:00 - 18:59Normal——
2026-09-26 17:00 - 17:59Normal——
2026-09-26 16:00 - 16:59Normal——
2026-09-26 15:00 - 15:59Normal——
2026-09-26 14:00 - 14:59Normal——
2026-09-26 13:00 - 13:59Normal——
2026-09-26 12:00 - 12:59Normal——
2026-09-26 11:00 - 11:59Normal——
2026-09-26 10:00 - 10:59Normal——
2026-09-26 09:00 - 09:59Normal——
2026-09-26 08:00 - 08:59Normal——
2026-09-26 07:00 - 07:59Normal——
2026-09-26 06:00 - 06:59Normal——
2026-09-26 05:00 - 05:59Normal——
2026-09-26 04:00 - 04:59Normal——
2026-09-26 03:00 - 03:59Normal——
2026-09-26 02:00 - 02:59Normal——
2026-09-26 01:00 - 01:59Normal——
2026-09-26 00:00 - 00:59Normal——
2026-09-25 23:00 - 23:59Normal——
2026-09-25 22:00 - 22:59Normal——
2026-09-25 21:00 - 21:59Normal——
2026-09-25 20:00 - 20:59Normal——
2026-09-25 19:00 - 19:59Normal——
2026-09-26Normal——
2026-09-25Normal——
2026-09-24Normal——
2026-09-23Normal——
2026-09-22Normal——
2026-09-21Normal——
2026-09-20Normal——
2026-09-19Normal——
2026-09-18Normal——
2026-09-17Normal——
2026-09-16Normal——
2026-09-15Normal——
2026-09-14Normal——
2026-09-13Normal——
2026-09-12Normal——
2026-09-11Normal——
2026-09-10Normal——
2026-09-09Normal——
2026-09-08Normal——
2026-09-07Normal——
2026-09-06Normal——
2026-09-05Normal——
2026-09-04Normal——
2026-09-03Normal——
2026-09-02Normal——
2026-09-01Normal——
2026-08-31Normal——
2026-08-30Normal——
2026-08-29Normal——
2026-08-28Normal——

Search public results on iQIYI. Accepts these parameters: site, published, scrape_additional_info, sort, keyword, quality, category, and publish_date. Returns these fields: title, posted_at, album_episode_count, and author_location.

Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

Request parameters

NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesiqiyiPlatform identifier, fixed value.
actionbodystringYessearchCapability identifier, fixed value.
keywordbody.paramsNot declaredYes-Specifies search terms for the search action, or series, album, and cast-member names for the international album action. The album action does not fetch details directly from album URLs, and available libraries vary by region.
categorybody.paramsenumNo-Filters video content by category, accepting allowed values such as 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, or all (unrestricted). This parameter filters broad categories rather than cast-member or series tags.Allowed valuesadvertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows
publish_datebody.paramsNot declaredNo-Filters search action results by publication timeframe, accepting all, last_24_hours, last_7_days, or last_30_days. This field does not accept YYYY-MM-DD dates, and when both this field and published are present, published takes precedence.
publishedbody.paramsNot declaredNo-Overrides publish_date in the search action, accepting all, last_24_hours, last_7_days, or last_30_days. This field is a string filter and does not accept boolean true/false values.
qualitybody.paramsNot declaredNo-Filters iQIYI search results by the requested video quality. Common values include all, hd, ultra_hd, 720p, and 1080p. It is not a download or transcoding option, and unrecognized values may have no effect because this API does not declare a closed value set.
scrape_additional_infobody.paramsNot declaredNo-Controls whether iQIYI search results include additional uploader and engagement information. Pass a JSON boolean; the default is true. Setting it to false disables that extra lookup but does not change the EveryInfra API price.
sitebody.paramsNot declaredNo-Provides a source-site condition for search. Common values include all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv, and m1905. It affects search sources, not the availability of detail endpoints, and this API does not declare a closed value set.
sortbody.paramsenumNo-Controls sorting order for video search results, accepting relevance, newest, or popular. It does not sort by user ratings or episode release sequences, and has no effect when requesting a single video.Allowed valuesnewestpopularrelevance
limitbody.paramsinteger (1–50)No20

Code samples

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 definition (JSON)]Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Field preview

There is no real sample for these example parameters yet: this shows the response shape and fields from the contract, with … as placeholders. It is not the result of a real call.

json
{
  "id": "req_…",
  "platform": "iqiyi",
  "action": "search",
  "results": [
    {
      "id": …,
      "url": …,
      "title": …,
      "text": …,
      "category": …,
      "category_id": …,
      "duration_seconds": …,
      "heat_count": …,
      "rating": …,
      "rating_scale": …,
      "rating_count": …,
      "like_count": …,
      "comment_count": …,
      "collect_count": …,
      "album_id": …,
      "album_title": …,
      "album_url": …,
      "album_episode_count": …,
      "image_url": …,
      "wide_image_url": …,
      "author_name": …,
      "author_id": …,
      "author_avatar_url": …,
      "author_follower_count": …,
      "author_video_count": …,
      "author_location": …,
      "author_org": …,
      "posted_at": …,
      "platform": …,
      "cast": …
    }
  ],
  "count": …,
  "billing": { … },
  "quota": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the source does not provide are never made up.

FieldMeaning
idThe record's unique ID on the source platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the source platform.
titleTitle. null when the platform has no titles (for example text-only posts).
textBody text with HTML removed. Long text may be truncated.
categoryCategory name in the source platform's own taxonomy, not normalized across platforms.
category_idKeeps the platform's own meaning
duration_secondsDuration in seconds. null for content that is not video or audio.
heat_countKeeps the platform's own meaning
ratingRating. The scale varies by platform: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards.
rating_scaleMaximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating.
rating_countNumber of people who rated. null means not disclosed, not 0.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
collect_countSaves or favorites. null means not disclosed, not 0.
album_idKeeps the platform's own meaning
album_titleKeeps the platform's own meaning
album_urlKeeps the platform's own meaning
album_episode_countKeeps the platform's own meaning
image_urlImage link. Capabilities with several images may return an image_urls array.
wide_image_urlKeeps the platform's own meaning
author_nameAuthor's display name.
author_idAuthor's unique ID on the source platform.
author_avatar_urlKeeps the platform's own meaning
author_follower_countAuthor's follower count. null means not disclosed.
author_video_countKeeps the platform's own meaning
author_locationKeeps the platform's own meaning
author_orgKeeps the platform's own meaning
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
castKeeps the platform's own meaning

Errors and billing

401
Missing or invalid key. Authentication runs before parameter checks, so unauthenticated requests never see the parameter schema.
422
Wrong parameter name or value. The error lists the parameters and allowed values this capability accepts and the closest match; it happens before any charge.
402
Insufficient balance. Top up first.
429
Per-minute request limit reached. Wait for Retry-After and try again.
503
Could not complete right now. Any charge for the call goes back to your balance automatically, and the billing receipt in the response states the actual outcome, including when it is not yet known. Do not resend blindly.
200 empty
The request completed without data and is not charged (billing.reason = empty_result_refunded).

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

  • iQIYI: Difference Between Content Heat and On-Site Play Count ↗

    iQIYI's 2018 announcement explains content heat as a composite metric covering views, interactions, and shares, distinguishing it from play count. This only explains the metric type for heat_count and does not extrapolate current algorithms, thresholds, or cross-platform comparability, nor does it deduce actual play count from heat.

    Checked 2026-09-04