# Riferimento API

Parametri delle richieste, schemi delle risposte ed esempi funzionanti per ogni fonte.

Riferimento canonico: https://flashdata.dev/it/docs/reference

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

## Richiesta di base

Impostare la sorgente per il prodotto di cui hai bisogno e autenticare con X-API-Key. Le pagine sottostanti contengono campi esatti, esempi di risposta e un costruttore di richieste interattivo.

### host API

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

| Flusso di lavoro | Richiesta | Resi |
| --- | --- | --- |
| Realtime · Dati API | POST /v1/queries/realtime | Risultati della risposta |
| Async · Dati API | POST /v1/queries | Un lavoro ID per stato e risultati |
| Batch · Dati API | POST /v1/queries/batch | Una ricevuta separata per query |
| Bulk · Management API | POST /v2/bulk-jobs | A Bulk ID e caricatore di file di input firmato URL |
| Lavoro · Gestione API | GET /v2/jobs/{id} | Stato di un lavoro esistente |

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

Novità allo API? Impostare la chiave e eseguire una prima richiesta completa.

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

## Nozioni di base sulle API

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

Ottenere risultati nella risposta, o inviare un lavoro e recuperarli più tardi. Scegli come la tua applicazione o agente aspetta il lavoro.

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

Scegliere Batch per domande indipendenti con diversi input. Scegliere Bulk per un file di video IDs che tutti hanno bisogno della stessa operazione.

### [Formati di risposta](https://flashdata.dev/it/docs/guides/response-formats/reference.md)

Scegli il contenuto JSON strutturato per la tua applicazione o Markdown per un agente AI. Controllare la risposta con due intestazioni.

### [Errori e codici di stato](https://flashdata.dev/it/docs/errors/reference.md)

Leggi la risposta di errore e decidi se correggere, riprovare o interrompere.

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

## Google Search

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

Recuperare i risultati organici, le domande correlate e i risultati ricchi da Google Cerca come strutturato JSON. Filtra per paese, lingua e posizione.

source: `google_search`

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

Cerca Google Immagini e recupera l'immagine originale URLs, miniature, dimensioni e pagine di origine come JSON.

source: `google_images`

### [Notizie](https://flashdata.dev/it/docs/sources/google_news/reference.md)

Recuperare gli articoli Google News con titoli, pubblicazioni, link e date di pubblicazione. Filtra per paese, lingua e data range.

source: `google_news`

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

Cerca Google Shopping per i prodotti e recuperare i prezzi, i commercianti, le valutazioni e i collegamenti di prodotto in JSON strutturato.

source: `google_shopping`

### [Video](https://flashdata.dev/it/docs/sources/google_videos/reference.md)

Trova i video su siti web con i video Google. Recuperare titoli, link video, miniature, durata e informazioni di origine.

source: `google_videos`

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

Ricerca per le aziende locali e luoghi. Recuperare nomi, indirizzi, coordinate, valutazioni e dettagli di contatto quando disponibile.

source: `google_places`

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

## YouTube Data

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

Cerca video YouTube per parole chiave e recupera titoli, canali, durata, conteggi di visualizzazione e miniature come JSON.

source: `youtube_search`

### [Ricerca estesa](https://flashdata.dev/it/docs/sources/youtube_search_extended/reference.md)

Recupera fino a 700 YouTube risultati di ricerca per richiesta, con dettagli video, miniature e filtri di ricerca.

source: `youtube_search_extended`

### [Metadati video](https://flashdata.dev/it/docs/sources/youtube_metadata/reference.md)

Recuperare i metadati video di YouTube video ID, compresi i dettagli del canale, conteggi di fidanzamento, miniature, formati e capitoli disponibili.

source: `youtube_metadata`

### [Trascrizione](https://flashdata.dev/it/docs/sources/youtube_transcript/reference.md)

Recuperare il testo di trascrizione YouTube con timestamp e una trascrizione completa. Le didascalie automatiche vengono selezionate per impostazione predefinita.

source: `youtube_transcript`

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

Recuperare le didascalie YouTube come testo timestamp e una trascrizione completa. Le didascalie fornite dal caricatore vengono selezionate per impostazione predefinita.

source: `youtube_captions`

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

Recuperare un profilo di canale YouTube e i suoi video recenti tramite maniglia, compresi i conteggi degli abbonati, le immagini dei canali e i dettagli video.

source: `youtube_channel`

### [Consigli](https://flashdata.dev/it/docs/sources/youtube_suggestions/reference.md)

Recuperare YouTube suggerimenti autocompleti per una parola chiave o una frase, con i controlli di lingua e regione.

source: `youtube_suggestions`

### [Etichette di licenza](https://flashdata.dev/it/docs/sources/youtube_trainability/reference.md)

Controllare i metadati di licenza di un video YouTube per un'etichetta Creative Commons e recuperare il risultato come JSON.

source: `youtube_trainability`

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

## YouTube Download

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

Scarica il video o l'audio YouTube sul tuo storage cloud. Scegliere risoluzione, formato e durata della clip, quindi monitorare il lavoro asincrono attraverso il completamento.

source: `youtube_download`

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

## Elaborazione in blocco

### [API di elaborazione Bulk](https://flashdata.dev/it/docs/reference/bulk-processing/reference.md)

Creare e controllare i lavori YouTube basati su file, quindi recuperare i loro manifesti e parti di risultato.

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

## Riferimenti dei protocolli

### [Gestione API](https://flashdata.dev/it/docs/api-reference/reference.md)

Job, accesso agli account, registrazione degli agenti, collegamento all’account e consegna delle credenziali.

### [Strumenti e schemi MCP](https://flashdata.dev/it/docs/mcp/reference.md)

Argomenti degli strumenti, funzioni dell’account, job in background e risultati di grandi dimensioni.

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

## Specifiche e riferimenti dei client

### [Specifiche OpenAPI (JSON)](https://flashdata.dev/docs/openapi.json)

Operazioni e schemi leggibili dalle macchine per gli strumenti API.

### [Riferimento dei comandi CLI](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

Comandi, opzioni e codici di uscita per v1.2.1. Si apre su GitHub.

### [Riferimento dei metodi del Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

Metodi e tipi del client per v1.1.0. Si apre su GitHub.
