# Twitch Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/twitch/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/twitch-search |

## Description

Unlock Twitch data for Rocket League, offering real-time streaming insights for market analysis and strategic advantages.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/twitch/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "streams": [
    {
      "title": "Example Stream Title 1",
      "viewers": 1200,
      "streamer": "ExampleStreamer1",
      "stream_url": "https://www.twitch.tv/ExampleStreamer1",
      "thumbnail_url": "https://example.com/thumbnail1.jpg"
    },
    {
      "title": "Example Stream Title 2",
      "viewers": 850,
      "streamer": "ExampleStreamer2",
      "stream_url": "https://www.twitch.tv/ExampleStreamer2",
      "thumbnail_url": "https://example.com/thumbnail2.jpg"
    },
    {
      "title": "Example Stream Title 3",
      "viewers": 560,
      "streamer": "ExampleStreamer3",
      "stream_url": "https://www.twitch.tv/ExampleStreamer3",
      "thumbnail_url": "https://example.com/thumbnail3.jpg"
    }
  ],
  "category": "Rocket League",
  "total_streams": 3
}
```

## Documentation

## Overview
Unlock Twitch data for Rocket League, offering real-time streaming insights for market analysis and strategic advantages.

## Quickstart
```
GET https://api.piloterr.com/v2/twitch/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Twitch Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Twitch without maintaining scrapers
- Power internal dashboards and workflow automations with live Twitch data