# NetShort Recommendations Scraper (`spider_studio/netshort-recommendations`) Actor

Collect unique NetShort For You recommendations with a maximum-results limit. Export short-drama IDs, titles, covers and descriptions as JSON, CSV or Excel.

- **URL**: https://apify.com/spider_studio/netshort-recommendations.md
- **Developed by:** [Tarique](https://apify.com/spider_studio) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 netshort recommendation results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### NetShort Recommendations Scraper: discover recommended short dramas

**NetShort Recommendations Scraper** collects short dramas from the NetShort For You feed and saves the available recommendation data for export. Use this **NetShort discovery API** to find titles for content research, create a review queue, or expand a short-drama catalog beyond keyword search.

### 🧭 Explore more NetShort Actors

Build your NetShort workflow with these companion Actors:

| Actor | What it does |
| --- | --- |
| 🔎 [NetShort Search Scraper](https://apify.com/spider_studio/netshort-search) | Find dramas by keyword and collect their IDs. |
| 📋 [NetShort Drama Episodes Scraper](https://apify.com/spider_studio/netshort-drama-episodes) | Get episode IDs, catalogs, and detailed metadata. |
| 🔗 [NetShort 1080p Video URL Scraper](https://apify.com/spider_studio/netshort-drama-playback-urls) | Extract playback links for free-user episodes. |
| 🎬 [NetShort Video Downloader](https://apify.com/spider_studio/netshort-video-downloader) | Download full dramas or selected episodes as MP4 files, with automatic unlocking and quality up to 1080p. |

### What can you do with NetShort recommendations?

Discover titles you might miss when searching for a specific phrase. Recommendation results can help you explore new genres, collect drama IDs for deeper research, and build a list of candidates for licensed content review. Save dated exports to compare the titles you receive across different runs.

A recommendation feed is a snapshot, not a guaranteed ranking of the most popular NetShort dramas. Its contents can change between runs. Treat it as a source of discovery rather than a complete catalog or a reproduction of your personal NetShort feed.

### How to collect recommended NetShort dramas

1. Open the **Input** tab.
2. Set **Maximum results** to the number of unique dramas you want to save.
3. Click **Start** and review the Dataset.
4. Export the results, or use their drama IDs with a companion Actor above.

Collection automatically continues until it reaches your maximum, the source has no more results, or your charge budget is exhausted. Duplicate titles do not use up additional result charges. Start with a small maximum to review the output before collecting a larger selection.

### Input for the NetShort recommendations API

The only input is `max_results`, an integer from **1 to 10,000**, with a default of **100**. It is a strict limit on saved results, not a guarantee that this many titles are currently available. If fewer results exist, the Actor returns only those it can find.

```json
{
  "max_results": 100
}
```

Use a smaller value, such as `10`, for a quick sample. Increase the maximum for a larger research list. There are no other input options to configure, and each run starts collection automatically. Set a maximum run cost in Apify Console when you also want to limit spending.

The recommendation feed changes over time, so two runs may discover different titles. Use the saved drama IDs to compare exports and identify new titles.

### What does the recommendations scraper return?

Each unique recommended drama produces one Dataset row, with repeated titles saved once. Rows include `short_play_id`, `title`, `cover_url`, `description`, `labels`, `success`, and a `result` object containing the available title details. Non-drama feed cards are not included as paid results.

```json
{
  "short_play_id": "1894649662050627585",
  "title": "Example drama",
  "success": true,
  "error": null
}
```

This excerpt shows the main fields. Available titles and optional details can change between runs. Export the Dataset as JSON, CSV, Excel, or HTML. Open **Result summary** to review saved counts, empty requests, errors, and any stop caused by your budget.

### Pricing and run costs

Free-plan users pay **$0.003 per successfully saved recommended drama**. Paid-plan users pay **$0.002 per successfully saved recommended drama**. Charges are based on individual titles, not on the number of requests or batches. Duplicates within a run, empty responses, and failed requests do not incur a result charge. Apify platform costs are additional. Review the **Pricing** tab and the run's **Usage** tab for actual costs.

### Can I automate NetShort content discovery?

Yes. Call the Actor through the **Apify API**, use a schedule for recurring snapshots, or connect the output to your reporting and automation tools. Keep the run date with each export so comparisons remain meaningful.

### Does this download the recommended videos?

The output is recommendation data. Use **NetShort Video Downloader** for MP4 files, or **NetShort Drama Episodes Scraper** to inspect the episodes belonging to a title.

### Support and responsible use

For missing results or other problems, open the **Issues** tab and include the run link and your maximum result setting. Access, reuse, and retain NetShort content only where you have permission and in accordance with applicable terms and copyright rules.

# Actor input Schema

## `max_results` (type: `integer`):

Maximum number of unique dramas to save. Fewer may be available. Collection stops at this limit or your charge budget.

## Actor input object example

```json
{
  "max_results": 100
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "max_results": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/netshort-recommendations").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "max_results": 100 }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/netshort-recommendations").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "max_results": 100
}' |
apify call spider_studio/netshort-recommendations --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spider_studio/netshort-recommendations"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hpzEnHkYWLoNnCea9/builds/OaB0ixFk6I8oETxK6/openapi.json
