LinkedIn Ad Library API
Trova gli annunci pubblici di LinkedIn con input di ricerca strutturati, poi recupera i record di trasparenza selezionati tramite l’URL di dettaglio esatto, per ricerca, verifica e archiviazione.
API di LinkedIn Ad Library disponibili
Usa Ad Search per trovare i record pubblici per azienda, ID azienda o parola chiave e Ad Details per recuperare un record noto dal suo URL pubblico esatto.
Quali dati di LinkedIn Ad Library puoi recuperare?
SocQ normalizza i campi pubblici di trasparenza senza presentarli come analisi private delle campagne; i valori della fonte non disponibili restano null o vuoti.
Identità di annuncio e inserzionista
Recupera ID stabili degli annunci, URL pubblici di dettaglio, ID degli inserzionisti, nomi, URL delle aziende e loghi, quando esposti.
Contesto di creatività e destinazione
Raccogli testi degli annunci, formati, risorse di immagini o video, posizionamenti e destinazioni delle landing page, quando disponibili.
Informazioni pubbliche sulla diffusione
Conserva date di pubblicazione, paesi, piattaforme, impression e orari di raccolta forniti dalla fonte.
SocQ vs LinkedIn Campaign Manager
SocQ raccoglie le informazioni pubbliche di trasparenza di Ad Library. Campaign Manager è il prodotto separato di LinkedIn per gli inserzionisti autorizzati che gestiscono le proprie campagne.
| Funzionalità | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Uso principale | Trovare e normalizzare i record pubblici degli annunci | Creare e gestire campagne autorizzate |
| Input | Ricerca per azienda o parola chiave, oppure un URL di dettaglio esatto | Identificatori autorizzati di account e campagna |
| Autenticazione | Chiave API di SocQ | Account LinkedIn e permessi pubblicitari |
| Output | Campi pubblici di trasparenza | Configurazione e reportistica private delle campagne |
Come funzionano le API di LinkedIn Ad Library
Entrambi gli endpoint usano il flusso asincrono di SocQ per invio, interrogazione e lettura; Search può restituire più pagine, mentre Ad Details restituisce al massimo un record.
1. Scegli un endpoint
Invia un’azienda, un ID azienda o una parola chiave a Search, oppure un URL di dettaglio pubblico esatto di Ad Library a Ad Details.
2. Invia e segui l’attività
Invia la richiesta con POST, salva il task_id e interroga /v1/tasks/{task_id} finché l’elaborazione termina.
3. Leggi i record normalizzati
Elabora data.results.items e segui next_cursor finché has_more è true; una richiesta di dettaglio restituisce zero o un elemento.
Autenticati con la tua chiave API di SocQ. Search restituisce 24 risultati per impostazione predefinita; Ad Details accetta un solo URL di dettaglio esatto e non pagina.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"Microsoft","countries":["US"],"results_limit":24}'
# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}Casi d’uso comuni delle API di LinkedIn Ad Library
Ricerca degli annunci dei concorrenti
Trova gli annunci pubblici osservabili associati ad aziende selezionate e conserva il loro contesto di trasparenza per la revisione.
Analisi delle creatività
Recupera i record selezionati ed esamina testi, media, formati, destinazioni, inserzionisti e periodi di pubblicazione disponibili.
Dataset pubblicitari pubblici
Salva campi normalizzati di identità dell’annuncio, inserzionista, creatività, diffusione, origine e raccolta per l’analisi.
Limiti e policy sui dati pubblici
I risultati riflettono l’indice pubblico e la visibilità dei record disponibili al momento della raccolta e non sono dati privati di Campaign Manager.
- Search richiede almeno uno tra company, keyword e company_id; i campi combinati seguono il comportamento di corrispondenza della fonte.
- countries accetta codici di due lettere, le date devono formare un intervallo valido e results_limit è un multiplo di 24 da 24 a 1.992.
- Una ricerca completata può non contenere elementi o contenere righe ripetute della fonte; anche un URL di dettaglio non disponibile può non restituire alcun record.
- I campi di inserzionista, creatività, diffusione, impression, destinazione, formato e media possono essere assenti e non vanno interpretati come zero.
Domande frequenti sulle API di LinkedIn Ad Library
Che cosa posso inviare?
Search accetta il nome di un’azienda, un ID azienda, una parola chiave o una combinazione supportata. Ad Details accetta un solo URL di dettaglio pubblico esatto di LinkedIn Ad Library.
Questa API restituisce analisi private delle campagne?
No. Restituisce le informazioni pubbliche disponibili e non espone spesa, clic, conversioni, regole di targeting né dati dell’account di Campaign Manager.
Quanti record possono restituire gli endpoint?
Search restituisce 24 record per impostazione predefinita e accetta multipli di 24 fino a 1.992. Ad Details restituisce zero o un record.
Come vengono fatturati i risultati?
Ogni record di annuncio restituito costa 0,5 crediti. Un’attività riuscita senza record non ha costi per risultato.
Combina i dati di più piattaforme per analisi di business più complete
Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.
Threads API
Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.
Snapchat API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.
Twitch API
Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.

