> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrape.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Core

> Real-time social data infrastructure for Twitter/X, Telegram, and Discord

Scrapest is a real-time social data infrastructure that captures and delivers posts from **Twitter/X**, **Telegram**, and **Discord** — with sub-second latency, zero rate limits, and no official API dependency.

## Supported Sources

<CardGroup cols={3}>
  <Card title="Twitter / X" icon="twitter" href="../sources/twitter">
    Track users, search tweets, token mentions, backfill history
  </Card>

  <Card title="Telegram" icon="telegram" href="../sources/telegram">
    Monitor groups & channels, token mentions, backfill history
  </Card>

  <Card title="Discord" icon="discord" href="../sources/discord">
    Track channels & servers, token mentions, backfill history
  </Card>
</CardGroup>

## How It Works

1. **Track** — Add sources (Twitter users, Telegram groups, Discord servers) via [REST API](/rest-api-reference/create-tracking) or [Dashboard](https://admin.scrape.st)
2. **Receive** — Get data instantly via [Webhooks](/rest-api-reference/create-webhook), [WebSocket](/streams/websocket-connections), or [SSE](/streams/public-sse)
3. **Query** — Search tweets, fetch user profiles, or pull historical data on demand via [REST API](/rest-api-reference/introduction-to-rest-api)

## Delivery Methods

| Method        | Latency   | Auth         | Use Case                               |
| ------------- | --------- | ------------ | -------------------------------------- |
| **Webhooks**  | \~200ms   | `x-api-key`  | Event-driven push to your endpoint     |
| **WebSocket** | \~50ms    | `x-api-key`  | High-frequency bidirectional streaming |
| **SSE**       | \~50ms    | Token / None | Simple real-time with auto-reconnect   |
| **REST API**  | On-demand | `x-api-key`  | Query data when you need it            |

## Monitoring & Metrics

Scrapest exposes real-time system health and latency metrics via public endpoints — no authentication required.

| Endpoint               | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `GET /health`          | System status (`healthy`, `degraded`, `critical`) |
| `GET /metrics`         | Aggregated latency P50/P95/P99 (24h window)       |
| `GET /metrics/:source` | Per-source latency (twitter, discord, telegram)   |

<Info>
  All metrics use a **24-hour rolling window**. See the full [Health & Metrics
  API reference](/rest-api-reference/health-endpoints) for response schemas.
</Info>

## Quick Start

1. **Login** at [admin.scrape.st](https://admin.scrape.st) via Telegram
2. **Create API Key** in dashboard
3. **Set Webhook** endpoint
4. **Track** a source — [X](/sources/x), [Telegram](/sources/telegram), or [Discord](/sources/discord)

```bash theme={null}
# Track an X user
curl -X POST https://scrape.st/track/x \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sid": "elonmusk"}'
```

***

*See [Benchmarks](./benchmarks) to see how Scrapest compares to the official X API.*