Threads Download

Parâmetros

Resposta

Exemplo de resposta real

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

# Threads Download

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

Baixa vídeos e imagens de posts do Threads (Meta). Suporta tanto conteúdos em vídeo quanto imagens estáticas de posts públicos.

Categoria: Downloads · Slug: `threads-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 post do Threads (ex: https://www.threads.net/@usuario/post/...) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `urls` | `string[]` | URLs de download direto das mídias |
| `type` | `string` | Tipo do conteúdo: 'video' ou 'image' |
| `title` | `string` | Texto do post |
| `thumbnail` | `string` | URL da thumbnail do conteúdo |
| `duration` | `integer` | Duração do vídeo em segundos |
| `author` | `string` | ID do autor do post |
| `author_name` | `string` | Nome de usuário do autor |

## Exemplo (curl)

```bash
curl "https://api.nyqo.dev/api/v1/threads/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": "Post 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.