Torna alle API
Dati indipendenti sulla pubblicità pubblica

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àSocQLinkedIn Campaign Manager
Uso principaleTrovare e normalizzare i record pubblici degli annunciCreare e gestire campagne autorizzate
InputRicerca per azienda o parola chiave, oppure un URL di dettaglio esattoIdentificatori autorizzati di account e campagna
AutenticazioneChiave API di SocQAccount LinkedIn e permessi pubblicitari
OutputCampi pubblici di trasparenzaConfigurazione 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. 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. 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. 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.

Cerca gli annunci pubblici di LinkedIn

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.

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.