Hongguo Short Drama Recommendation Feed API

Hongguo short drama recommendation scraper and feed API

Hongguo Short Drama Recommendation Feed API is a Hongguo short-drama scraper and recommendation API for discovering titles featured by Hongguo Duanju. It exports one normalized Dataset item per short-drama series, including the title, cover, synopsis, episode count, series ID, first video ID, and recommendation labels.

Use it when you need Hongguo recommendations, trending Chinese short dramas, catalog discovery data, or a machine-readable alternative to manually browsing the Hongguo recommendation feed. The Actor extracts metadata only; it does not download or redistribute episodes.

Why use this Hongguo recommendation scraper?

• Discover short dramas without preparing search keywords.
• Request up to 5,000 unique recommendations in one run.
• Export clean series metadata for research, monitoring, and catalog workflows.
• Get seriesId and firstVideoId values for use with other Hongguo Actors.
• Keep the original recommendation object with includeRaw when you need additional fields.
• Automate collection through the Apify API, schedules, webhooks, Make, or n8n.
• Download results as JSON, CSV, Excel, XML, or HTML.

Common use cases include Hongguo recommendation monitoring, Chinese short-drama discovery, content research, title tracking, catalog enrichment, and building a Hongguo short drama dataset.

What Hongguo recommendation data can the Actor extract?

Field	Type	Description
position	integer	First appearance of the series in the run.
seriesId	string	Hongguo short-drama series identifier.
title	string	Series title.
intro	string	Short-drama synopsis when available.
coverUrl	string	Cover image URL.
episodeCount	integer	Reported number of episodes.
firstVideoId	string	First episode video ID.
recommendReasons	array	Recommendation or popularity labels.
raw	object	Original recommendation data when requested.

How to scrape Hongguo short-drama recommendations

1. Open the Actor's Input tab.
2. Set maxResults to the maximum number of unique recommendations you want.
3. Choose whether to include the original data in raw.
4. Click Start.
5. Open the Dataset to review, download, or send the results to another service.

How much does Hongguo recommendation extraction cost?

FREE-tier users pay $3 per 1,000 successful recommendations ($0.003 per successful result). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay $2 per 1,000 ($0.002 per result). Apify FREE-plan accounts can persist up to 200 successful recommendations per UTC calendar month in this Actor; the quota resets at 00:00 UTC on the first day of each month. Paid-plan accounts are not subject to this product quota. Diagnostic rows with success: false are not charged and do not consume the quota. Set a smaller maxResults value when you only need a sample of the feed.

If a FREE-plan run requests more than the remaining monthly quota, the Actor writes one uncharged Dataset diagnostic row with errorCode: "FREE_TIER_MONTHLY_QUOTA_REACHED", including processed, requested, skipped, limit, and reset details. Paid-plan runs never receive this quota row.

Input

See the Input tab for all options. maxResults accepts values from 1 to 5,000 and defaults to 50. Duplicate series are excluded from the successful result count.

{
  "maxResults": 50,
  "includeRaw": true
}

Output

You can download the Dataset in formats such as JSON, HTML, CSV, or Excel.

{
  "success": true,
  "position": 1,
  "seriesId": "7639686403294497854",
  "title": "Example Short Drama",
  "intro": "Synopsis of a popular short drama",
  "coverUrl": "https://example.com/cover.jpg",
  "episodeCount": 80,
  "firstVideoId": "7639688323115519038",
  "recommendReasons": ["Trending"],
  "error": null
}

Hongguo recommendation scraper use cases

• Track which Hongguo short-drama titles are currently being recommended.
• Discover series IDs before collecting episode details.
• Build short-drama watchlists, catalogs, or editorial research datasets.
• Compare recommendation snapshots over time by seriesId.
• Enrich analytics pipelines with covers, episode counts, and recommendation reasons.

Related Hongguo Actors

Actor	Purpose
Hongguo Short Drama Keyword Suggestions API	Discover autocomplete and related keywords.
Hongguo Short Drama Search & Data Scraper API	Find short dramas and series IDs by keyword.
Hongguo Series Details & Episodes Scraper API	Turn a seriesId into complete metadata and episode video IDs.
Hongguo Best Quality Video URL Extractor API	Resolve the best available URL and quality metadata for an authorized video ID.
Hongguo All Video Qualities & URL Extractor API	Retrieve every available quality and URL for an authorized video ID.
Hongguo Full Series Downloader & Video Decryption API	Download and decrypt every episode directly from one or more seriesIds into Apify KVS.
Hongguo Video Downloader & Decryption API	Download and decrypt videos to playable MP4 files in user-owned storage.
Hongguo Short Drama Video Downloader API to KVS	Download and decrypt videos to playable MP4 files in the run KVS without cloud-storage credentials.

Frequently asked questions

Does the recommendation feed return Hongguo series and video IDs?

Yes. Successful results include seriesId and, when available, firstVideoId, so you can connect recommendation discovery to series-detail and authorized episode workflows.

Is this a Hongguo API alternative?

Yes. It provides structured Hongguo recommendation data through the Apify Console and API, so you can use the feed in no-code automations or application code.

Why can a run return fewer items than maxResults?

maxResults is a maximum, not a guarantee. The available feed may contain fewer unique series, and recommendation availability can change between runs.

Can this Actor download Hongguo episodes?

No. It returns short-drama discovery metadata. To download every authorized episode from the returned seriesId, use the Hongguo Full Series Downloader & Video Decryption API.

Legal use and support

Use this Actor only for lawful purposes and respect Hongguo's terms, copyright, rate limits, privacy rules, and applicable law. The Actor is intended for public catalog metadata and does not access private user accounts.

Use the Issues tab for support and the API tab for programmatic integration examples.