# Referência da API

Parâmetros, esquemas de resposta e exemplos funcionais para cada fonte.

Referência canônica: https://flashdata.dev/pt/docs/reference

<a id="request-basics"></a>

## Peça o básico

Defina a fonte do produto que precisa e autentique com X-API-Key. Páginas fontes abaixo contêm campos exatos, exemplos de resposta e um construtor interativo de pedidos.

### API hosts

```text
Data API        https://data.flashdata.dev
Management API  https://api.flashdata.dev
Header          X-API-Key: YOUR_API_KEY
```

| Fluxo de trabalho | Requisição | Retorna |
| --- | --- | --- |
| Realtime · Data API | POST /v1/queries/realtime | A fonte resulta na resposta |
| Async · Data API | POST /v1/queries | Um trabalho ID para status e resultados |
| Batch · Data API | POST /v1/queries/batch | Um recibo separado por consulta |
| Bulk · Management API | POST /v2/bulk-jobs | Bulk ID e upload de arquivo assinado URL |
| Trabalho · Gestão API | GET /v2/jobs/{id} | Status de um trabalho existente |

### [API](https://flashdata.dev/pt/docs/guides/http-quickstart/reference.md)

Novo no API?

<a id="api-basics"></a>

## Conceitos básicos da API

### [Realtime e async](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md)

Obter resultados na resposta, ou enviar um trabalho e recuperá-los mais tarde. Escolha como sua aplicação ou agente espera pelo trabalho.

### [Batch e volume](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md)

Escolha Batch para consultas independentes com diferentes entradas. Escolha Bulk para um arquivo de vídeo IDs que todos precisam da mesma operação.

### [Formatos de resposta](https://flashdata.dev/pt/docs/guides/response-formats/reference.md)

Escolha JSON estruturado para sua aplicação ou conteúdo Markdown para um agente de IA. Controle a resposta com dois cabeçalhos.

### [Erros e códigos de status](https://flashdata.dev/pt/docs/errors/reference.md)

Interprete uma resposta de erro e decida se deve corrigir, tentar novamente ou parar.

<a id="google-search"></a>

## Google Search

### [Pesquisar](https://flashdata.dev/pt/docs/sources/google_search/reference.md)

Recuperar resultados orgânicos, perguntas relacionadas e ricos resultados de Google Search como JSON estruturado. Filtrar por país, idioma e localização.

source: `google_search`

### [Imagens](https://flashdata.dev/pt/docs/sources/google_images/reference.md)

Pesquise imagens Google e recupere imagens originais URLs, miniaturas, dimensões e páginas de origem como JSON.

source: `google_images`

### [Notícias](https://flashdata.dev/pt/docs/sources/google_news/reference.md)

Recupere artigos de notícias Google com manchetes, publicações de origem, links e datas de publicação. Filtrar por país, idioma e faixa de data.

source: `google_news`

### [Compras](https://flashdata.dev/pt/docs/sources/google_shopping/reference.md)

Procure Google Comprando produtos e recuperando preços, comerciantes, classificações e links de produtos em JSON estruturado.

source: `google_shopping`

### [Vídeos](https://flashdata.dev/pt/docs/sources/google_videos/reference.md)

Encontre vídeos em sites com vídeos Google. Recuperar títulos, links de vídeo, miniaturas, durações e informações de origem.

source: `google_videos`

### [Lugares](https://flashdata.dev/pt/docs/sources/google_places/reference.md)

Procure por negócios e lugares locais. Recupere nomes, endereços, coordenadas, classificações e dados de contato quando disponíveis.

source: `google_places`

<a id="youtube-data"></a>

## YouTube Data

### [Pesquisar](https://flashdata.dev/pt/docs/sources/youtube_search/reference.md)

Pesquise vídeos YouTube por palavra-chave e recupere títulos, canais, durações, contagens de visualizações e miniaturas como JSON.

source: `youtube_search`

### [Pesquisa ampliada](https://flashdata.dev/pt/docs/sources/youtube_search_extended/reference.md)

Recupere até 700 YouTube resultados de busca por solicitação, com detalhes de vídeo, miniaturas e filtros de pesquisa.

source: `youtube_search_extended`

### [Metadados de vídeos](https://flashdata.dev/pt/docs/sources/youtube_metadata/reference.md)

Recuperar metadados de vídeo por YouTube vídeo ID, incluindo detalhes do canal, contagens de engajamento, miniaturas, formatos disponíveis e capítulos.

source: `youtube_metadata`

### [Transcrição](https://flashdata.dev/pt/docs/sources/youtube_transcript/reference.md)

Recupere o texto da transcrição YouTube com datas e uma transcrição completa. Legendas automáticas são selecionadas por padrão.

source: `youtube_transcript`

### [Legendas](https://flashdata.dev/pt/docs/sources/youtube_captions/reference.md)

Recupere as legendas YouTube como texto com data e uma transcrição completa. Legendas fornecidas pelo carregador são selecionadas por padrão.

source: `youtube_captions`

### [Canal](https://flashdata.dev/pt/docs/sources/youtube_channel/reference.md)

Recupere um perfil de canal YouTube e seus vídeos recentes por alça, incluindo contagens de assinantes, imagens de canal e detalhes de vídeo.

source: `youtube_channel`

### [Sugestões](https://flashdata.dev/pt/docs/sources/youtube_suggestions/reference.md)

Recuperar YouTube sugestões autocompletas para uma palavra-chave ou frase, com controle de linguagem e região.

source: `youtube_suggestions`

### [Rótulos de licença](https://flashdata.dev/pt/docs/sources/youtube_trainability/reference.md)

Verifique os metadados de licença de um vídeo YouTube para uma etiqueta Creative Commons e recupere o resultado como JSON.

source: `youtube_trainability`

<a id="youtube-download"></a>

## YouTube Download

### [Baixar](https://flashdata.dev/pt/docs/sources/youtube_download/reference.md)

Baixe o vídeo ou áudio YouTube para o seu armazenamento na nuvem. Escolha resolução, formato e duração do clipe, e depois rastreie o trabalho assíncrono através da conclusão.

source: `youtube_download`

<a id="bulk-processing"></a>

## Processamento em massa

### [API de processamento Bulk](https://flashdata.dev/pt/docs/reference/bulk-processing/reference.md)

Criar e controlar trabalhos YouTube baseados em arquivos, e então recuperar seus manifestos e partes de resultados.

<a id="group-5"></a>

## Referências de protocolos

### [API de gerenciamento](https://flashdata.dev/pt/docs/api-reference/reference.md)

Trabalhos, acesso à conta, registro de agentes, vinculação e transferência de credenciais.

### [Ferramentas e esquemas MCP](https://flashdata.dev/pt/docs/mcp/reference.md)

Argumentos das ferramentas, consultas à conta, trabalhos em segundo plano e resultados grandes.

<a id="group-6"></a>

## Especificações e referências de clientes

### [Especificação OpenAPI (JSON)](https://flashdata.dev/docs/openapi.json)

Operações e esquemas legíveis por máquina para ferramentas de API.

### [Referência de comandos da CLI](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

Comandos, opções e códigos de saída da v1.2.1. Abre o GitHub.

### [Referência de métodos do Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

Métodos e tipos do cliente v1.1.0. Abre o GitHub.
