LisbonaSiamo al Web Summit, stand A1-33.Vedi i dettagli
Feedance
Glossario · A

API (Application Programming Interface)

Definizione

Un'API, o interfaccia di programmazione delle applicazioni, è un contratto definito che permette a due software separati di scambiarsi dati e attivare azioni l'uno nell'altro senza che una persona debba gestirli manualmente. Nella gestione dei feed, le API sono ciò che consente al sistema di inventario di un merchant, a una piattaforma di gestione dei feed e a un canale di shopping di comunicare direttamente tra loro, inviando avanti e indietro in automatico variazioni di prezzo, aggiornamenti di stock e nuove schede prodotto, invece di aspettare che qualcuno carichi un file secondo una programmazione. Mentre un flusso di lavoro tradizionale potrebbe aggiornare il feed una volta al giorno tramite FTP, un feed collegato via API può riflettere un esaurimento scorte o un calo di prezzo nel giro di pochi minuti.

Perché è importante per la gestione dei feed

Velocità e accuratezza si sommano su tutto il catalogo. Un retailer che vende diecimila SKU su cinque canali non può ricaricare manualmente un foglio di calcolo ogni volta che cambia un prezzo o un articolo si esaurisce; un'API permette a quell'aggiornamento di propagarsi automaticamente, evitando che gli annunci girino su schede esaurite o con prezzi sbagliati. Le API rendono inoltre la gestione dei feed estendibile: invece di essere limitato ai campi supportati dal modello di caricamento file di una piattaforma, uno strumento per i feed può chiamare direttamente l'API di un canale per inviare dati più ricchi, recuperare i motivi dei rifiuti o riportare le metriche di performance nello stesso sistema che gestisce il catalogo. Questo flusso bidirezionale è anche ciò che alimenta trigger in tempo reale come un webhook, in cui un evento esterno (un nuovo ordine, una variazione di prezzo nell'ERP) chiama un endpoint API nell'istante in cui si verifica, invece che a intervalli fissi. Man mano che lo shopping si sposta verso agenti AI e commercio conversazionale, avere un livello API pulito e ben documentato dietro il catalogo sta diventando un requisito di base più che un optional, un cambiamento che trattiamo nella nostra guida sulla preparazione dei feed per l'agentic commerce.

Come funziona

La maggior parte delle API legate ai feed segue un modello REST: un client invia una richiesta HTTP a uno specifico endpoint URL, include una chiave API o un token OAuth per l'autenticazione e riceve in risposta dati strutturati, di solito in formato JSON. Una richiesta per aggiornare il prezzo di un prodotto, ad esempio, potrebbe essere una chiamata PATCH a un endpoint come /products/{id}, con il nuovo prezzo inviato nel corpo della richiesta e un token di autorizzazione trasportato negli header HTTP. L'API definisce esattamente quali endpoint esistono, quali dati si aspetta ciascuno, cosa restituisce e cosa significano i codici di errore: è proprio questo contratto documentato a cui si riferisce il termine "interfaccia di programmazione delle applicazioni". Limiti di frequenza (rate limit), versioning e ambiti di autenticazione fanno tutti parte dello stesso contratto, e una piattaforma di feed deve rispettarli per non essere rallentata o bloccata dal canale con cui si sincronizza.

Esempio

<item>
  <g:id>SKU-88213</g:id>
  <title>Stainless Steel Pour-Over Coffee Dripper</title>
  <g:price>34.00 USD</g:price>
  <g:availability>in stock</g:availability>
  <custom_label_0>api_synced</custom_label_0>
  <last_synced_via>merchant-api-v3</last_synced_via>
  <last_updated>2026-08-15T09:41:00Z</last_updated>
</item>

I campi last_synced_via e last_updated qui sopra non sono attributi standard di Google o Meta, ma molte piattaforme di feed li tracciano internamente per mostrare quali articoli sono stati inviati tramite una connessione API diretta anziché con un caricamento di file in batch, e quanto sono aggiornati quei dati.

Concetti correlati

Un'API è il livello di trasporto che rende possibili diversi altri concetti della gestione dei feed: un webhook è essenzialmente una chiamata API al contrario, attivata da un evento anziché da una richiesta; i dati che transitano in entrambi sono di solito strutturati in JSON; e ogni richiesta trasporta header HTTP che autenticano la chiamata e descrivono i dati inviati. Capire le API è fondamentale per capire come le piattaforme di feed moderne restano sincronizzate con i canali quasi in tempo reale, invece che con una programmazione giornaliera fissa.

Scopri quali
prodotti rendono.

Collega il tuo feed e GA4. Mostriamo Product Score, 4T, Price War e Broken Size sul tuo catalogo.