# Find Top Viewed Minecraft Clips on Twitch

**Use case:** 

Extract top-viewed Minecraft clips from Twitch over the last week. Designed for content curators, media managers, and editors building viral highlight reels. Returns clip title, total view count, duration in seconds, broadcaster details, and clip URL. Change categorySlug or clipPeriod to gather clips for other games or timeframes.

## Input

```json
{
  "mode": "topClips",
  "searchQuery": "lirik",
  "searchType": "all",
  "channelNames": [],
  "categorySlug": "minecraft",
  "videoIds": [],
  "clipSlugs": [],
  "twitchUrls": [],
  "language": "EN",
  "streamSort": "VIEWER_COUNT",
  "streamTags": [],
  "streamType": "",
  "videoSort": "TIME",
  "clipPeriod": "LAST_WEEK",
  "clipSort": "VIEWS_DESC",
  "includeChannelClips": true,
  "includeChannelVideos": true,
  "onlyLive": false,
  "maxItems": 50
}
```

## Output

```json
{
  "recordType": {
    "label": "Record type"
  },
  "title": {
    "label": "Title"
  },
  "channelName": {
    "label": "Channel name"
  },
  "displayName": {
    "label": "Display name"
  },
  "viewersCount": {
    "label": "Viewers count"
  },
  "viewCount": {
    "label": "View count"
  },
  "gameName": {
    "label": "Game name"
  },
  "url": {
    "label": "Url"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Twitch Live Stream, Channel & VOD Metadata Extractor Actor is ready to run with the inputs already set for "Find Top Viewed Minecraft Clips on Twitch". [Sign up or log in](https://console.apify.com/create-task-from-example/SDdkZZbdAOwttJ4HL) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find Top Viewed Minecraft Clips on Twitch" task

The Twitch Live Stream, Channel & VOD Metadata Extractor Actor will start running based on the input automatically. You can also change all the input fields, like mode, search query (mode=search), and more, to match your specific use case.

### 3. Receive the "Find Top Viewed Minecraft Clips on Twitch" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as record type, title, channel name, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find Top Viewed Minecraft Clips on Twitch" task via API](https://apify.com/vexaloom-labs/twitch-live-stream-channel-and-vod-metadata.md).

## FAQ

### How can I find the most viewed Minecraft clips on Twitch?

The Minecraft Twitch clips task is set to return clips from Minecraft created in the last week, sorted by views. Each result includes a clip title, view count and URL.

### What details do Twitch Clips results Include?

Clip results from the Minecraft Twitch clips task can Include the title, total views, duration in seconds, broadcaster details and clip URL.

### Can I get Twitch clips for another game or time period?

Change the category or time window for the Minecraft Twitch clips task; available periods Include the last day, week, month or all time.

### Does finding Twitch clips require a login or API key?

The Minecraft Twitch clips task collects public Twitch data without a login, OAuth app or API key.

### How much does it cost to get 50 Twitch clip results?

For the Minecraft Twitch clips task, up to 50 results cost at most $0.05 on the Free plan. Actor start and Apify compute charges also apply.

### How can I download the Twitch clips data?

Results from the Minecraft Twitch clips task land in a dataset that can be downloaded as JSON, CSV, Excel, XML, RSS or an HTML table.

### Can I run the Minecraft clips search on a schedule or through an API?

You can run the Minecraft Twitch clips task on a schedule, through the Apify API, or with integrations such as Zapier, Make and n8n.

### Can I use Twitch clip data for a highlight reel?

The Minecraft Twitch clips task returns public clip metadata for curation, including titles, view counts, durations and URLs. You are responsible for checking site terms and data-protection laws such as GDPR or CCPA.

## About this Actor

This example demonstrates how to use [Twitch Live Stream, Channel & VOD Metadata Extractor](https://apify.com/vexaloom-labs/twitch-live-stream-channel-and-vod-metadata.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/vexaloom-labs/twitch-live-stream-channel-and-vod-metadata.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/vexaloom-labs/twitch-live-stream-channel-and-vod-metadata.md

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`).