linkedin-ad-library/
search

Cerca gli annunci LinkedIn pubblici per azienda, ID dell’azienda o parola chiave con filtri per paese e data, con campi normalizzati di inserzionista, creatività, erogazione, destinazione, impression e contenuti multimediali.

LinkedIn Ad Library Search API

Ricerca per azienda e parola chiave
Paginazione a 24 record
Divulgazioni pubbliche degli annunci
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

LinkedIn Ad Library Search

LinkedIn Ad Library Search individua gli annunci pubblici conservati a partire dal nome di un’azienda, dall’ID esatto dell’azienda, da una parola chiave o da una combinazione di questi input. I record restituiti normalizzano identità dell’inserzionista, testo creativo, URL di origine, periodo di erogazione, paesi, impression, formato, destinazione e contenuti multimediali disponibili, senza trattare i campi di divulgazione assenti come zero.

Funzionalità della LinkedIn Ad Library Search API

  • Tre input di scopertaCerca con il nome di un’azienda, una parola chiave, l’ID esatto dell’azienda su LinkedIn o più di questi campi in una sola richiesta; ne serve almeno uno.
  • Filtri per paese e dataRestringi l’indice pubblico con codici paese di due lettere e un intervallo facoltativo, estremi inclusi, delle date di erogazione nel formato YYYY-MM-DD.
  • Record pubblici normalizzati degli annunciRestituisce identità stabile dell’annuncio, riferimento all’inserzionista, testo creativo, URL di dettaglio, date, mercati, formato, destinazione, impression e contenuti multimediali, quando divulgati.
  • Paginazione limitata con tokenRaccogli da 24 a 1.992 record, in multipli di 24, mentre SocQ segue i nuovi token di paginazione a monte fino al limite o all’ultima pagina utilizzabile.
  • Flusso dalla ricerca al dettaglioPassa un URL /ad-library/detail/ restituito a LinkedIn Ad Library Ad quando un record individuato richiede la vista di dettaglio disponibile.

Parametri della LinkedIn Ad Library Search API

ParametriObbligatorioDescrizione
companyObbligatorio (almeno uno)Nome dell’azienda o dell’inserzionista. È richiesto almeno uno tra company, keyword o company_id.
keywordObbligatorio (almeno uno)Testo da cercare nella ricerca pubblica degli annunci. La semantica di corrispondenza dipende dalla fonte pubblica.
company_idObbligatorio (almeno uno)ID esatto dell’azienda su LinkedIn usato come input di ricerca.
countriesFacoltativoElenco facoltativo di codici paese alfabetici di due lettere, preferibilmente in maiuscolo, come US e CA.
start_dateFacoltativoInizio facoltativo del filtro pubblico sulla data di erogazione, nel formato YYYY-MM-DD.
end_dateFacoltativoFine facoltativa del filtro pubblico sulla data di erogazione, nel formato YYYY-MM-DD; non può precedere start_date.
results_limitFacoltativoNumero massimo di record richiesti. Il valore predefinito è 24 e sono accettati multipli di 24 da 24 a 1.992.

Come usare la LinkedIn Ad Library Search API

Scegli almeno un campo di scoperta, aggiungi solo i filtri che definiscono il tuo campione e leggi le pagine dell’attività asincrona completata.

  1. Indica company, keyword o company_id; combinali solo quando vuoi quella corrispondenza più ristretta definita dalla fonte.
  2. Aggiungi facoltativamente countries di due lettere, un intervallo di date valido e un results_limit multiplo di 24.
  3. Invia con POST la richiesta a /v1/linkedin-ad-library/search e salva il task_id restituito.
  4. Interroga /v1/tasks/{task_id}, poi leggi data.results.items e segui next_cursor finché has_more è true.
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}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della LinkedIn Ad Library Search API

  • Scoperta degli annunci di un inserzionista: Usa il nome di un’azienda o l’ID esatto dell’azienda per raccogliere gli annunci pubblici osservabili associati a un inserzionista al momento della raccolta.
  • Ricerca su messaggi e temi: Cerca parole chiave per prodotti, concorrenti o temi e confronta testi creativi, formati, contenuti multimediali e destinazioni restituiti.
  • Confronto tra mercati e finestre temporali: Ripeti la stessa query con filtri controllati per paese e data per confrontare le divulgazioni pubbliche su campioni definiti.
  • Selezione dei candidati per il dettaglio: Usa gli ID degli annunci e gli URL di dettaglio restituiti per selezionare singoli record da esaminare più da vicino con l’operazione di dettaglio separata.

Consigli degli esperti per la LinkedIn Ad Library Search API

  • Parti da un solo campo di scoperta, poi combina company, keyword e company_id solo quando un insieme di risultati più ristretto, definito dalla fonte, è utile.
  • Usa codici paese in maiuscolo per avere input salvati coerenti, anche se il validatore attuale accetta entrambe le forme.
  • Scegli results_limit a incrementi di 24 record e consideralo un tetto di raccolta, non la promessa che ogni posizione abbia una corrispondenza.
  • Conserva query, filtri e orario collected_at quando confronti le esecuzioni, perché la disponibilità pubblica e i record conservati cambiano.
  • Considera i valori mancanti di inserzionista, date, paese, impression, destinazione, formato o contenuti multimediali come dati di divulgazione non disponibili e non come zero.

Oltre alla LinkedIn Ad Library Search API, usa queste API quando ti serve un altro tipo di dati pubblici di LinkedIn Ad Library.

  • LinkedIn Ad Library Ad API — Recupera un record pubblico noto della LinkedIn Ad Library tramite l’URL esatto di dettaglio, con campi normalizzati di inserzionista, creatività, diffusione, destinazione, impression e media.

Esplora altre piattaforme

Combina i dati di LinkedIn Ad Library con i dati pubblici delle altre piattaforme social supportate.

LinkedIn Ad Library Search API — FAQ

LinkedIn Ad Library Search API è un’interfaccia programmatica per individuare i record pubblici conservati degli annunci LinkedIn a partire dal nome di un’azienda, dall’ID esatto dell’azienda, da una parola chiave o da una combinazione supportata. Restituisce i campi disponibili nella forma normalizzata degli annunci di SocQ.

Indica almeno uno tra company, keyword e company_id. Puoi inviarne più di uno insieme, ma la ricerca pubblica a monte controlla il loro esatto comportamento di corrispondenza e intersezione.

L’endpoint accetta un elenco di countries di due lettere più i valori facoltativi start_date e end_date. Non espone un’opzione pubblica di ordinamento.

Un record può includere identità dell’annuncio e dell’inserzionista, URL di dettaglio pubblico, testo creativo, date di inizio e fine, paesi, impression scalari, formato, posizionamenti, destinazione, contenuti multimediali e orario di raccolta, quando disponibili.

Al momento della raccolta nessun annuncio pubblico conservato può corrispondere ai campi di scoperta e ai filtri inviati. Un risultato vuoto non dimostra che l’inserzionista non abbia mai pubblicato annunci.

La fonte a monte restituisce fino a 24 annunci per pagina. SocQ segue ogni nuovo token di paginazione fino a results_limit, all’ultima pagina, a una pagina vuota, a un token mancante o a un token ripetuto.

Ogni annuncio normalizzato restituito costa 0,5 crediti SocQ. Un’attività riuscita senza record restituiti non ha alcun costo per i risultati.