Twitter/X Download

Parâmetros

Resposta

Exemplo de resposta real

{
		"success": true,
		"data": {
		  "urls": ["https://...video.mp4"],
		  "type": "video",
		  "title": "Tweet text",
		  "thumbnail": "https://...",
		  "duration": 30,
		  "author": "123456789",
		  "author_name": "Username"
		}
}

# Twitter/X Download

`GET https://api.nyqo.dev/api/v1/twitter/download`

Baixa vídeos e imagens de posts do Twitter/X. Suporta tweets com mídia única ou múltipla. Ideal para arquivar tweets importantes ou conteúdo de creators.

Categoria: Downloads · Slug: `twitter-download`

## Autenticação

```http
Authorization: Bearer nyq_sua_chave_aqui
```

Também aceito: `X-API-Key: nyq_sua_chave_aqui`. Nunca via query string (`?api_key`).

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `url` | `string` | sim | URL do tweet do Twitter/X (ex: https://twitter.com/usuario/status/123456789) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `urls` | `string[]` | Array de URLs de download direto em diferentes qualidades |
| `type` | `string` | Tipo do conteúdo: 'video' ou 'image' |
| `title` | `string` | Texto original do tweet |
| `thumbnail` | `string` | URL da thumbnail/preview do conteúdo |
| `duration` | `integer` | Duração do vídeo em segundos |
| `author` | `string` | ID numérico do autor do tweet |
| `author_name` | `string` | Nome de usuário do autor |

## Exemplo (curl)

```bash
curl "https://api.nyqo.dev/api/v1/twitter/download?url=https%3A%2F%2Fexemplo.com%2Fconteudo" \n  -H "Authorization: Bearer nyq_sua_chave_aqui"
```

## Exemplo de resposta

```json
{
		"success": true,
		"data": {
		  "urls": ["https://...video.mp4"],
		  "type": "video",
		  "title": "Tweet text",
		  "thumbnail": "https://...",
		  "duration": 30,
		  "author": "123456789",
		  "author_name": "Username"
		}
}
```

Erros comuns

• · 401 unauthorized — sem chave ou chave inválida. Confira autenticação.
• · 403 forbidden — plano sem esta rota ou chave fora do escopo. Veja planos.
• · 429 rate_limited — quota estourada; aguarde Retry-After. Detalhes em rate limits.

Tabela completa em /docs — códigos de erro.