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

# API

> Create, edit, start, and stop monitoring tasks from your own code with the Pro REST API

The Pro REST API manages the same tasks you see in the [dashboard](https://docs.tweet-catcher.com/monitor/tasks.md). To receive the events they produce, use the [WebSocket](https://docs.tweet-catcher.com/pro/websocket.md)

```text theme={null}
https://monitor-api.tweet-catcher.com/pro
```

## Authentication

Send your [API key](https://docs.tweet-catcher.com/monitor/settings.md#api) in the `Authorization` header

```bash theme={null}
curl https://monitor-api.tweet-catcher.com/pro/info \
  -H "Authorization: YOUR_KEY"
```

## Endpoints

> [card] [Manage tasks](https://docs.tweet-catcher.com/pro/api/manage-tasks/add-task.md)
>
> Read, create, edit, start, stop, and delete tasks

> [card] [User data](https://docs.tweet-catcher.com/pro/api/user-data/get-username-history.md)
>
> Username history of an X profile

## Errors

Errors return `error: true` and a `message`. Validation failures add `errors`, which maps each field to a list of messages

```json theme={null}
{
  "error": true,
  "message": "Invalid request parameters",
  "errors": { "module": ["Invalid module"] }
}
```

## Bulk endpoints

Bulk endpoints accept up to 200 tasks and stream one `progress` [Server-Sent Event](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) per task, then `done`. A failed task does not stop the batch, so check `result.error` on each `progress` event


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.