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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
company | Obbligatorio (almeno uno) | Nome dell’azienda o dell’inserzionista. È richiesto almeno uno tra company, keyword o company_id. |
keyword | Obbligatorio (almeno uno) | Testo da cercare nella ricerca pubblica degli annunci. La semantica di corrispondenza dipende dalla fonte pubblica. |
company_id | Obbligatorio (almeno uno) | ID esatto dell’azienda su LinkedIn usato come input di ricerca. |
countries | Facoltativo | Elenco facoltativo di codici paese alfabetici di due lettere, preferibilmente in maiuscolo, come US e CA. |
start_date | Facoltativo | Inizio facoltativo del filtro pubblico sulla data di erogazione, nel formato YYYY-MM-DD. |
end_date | Facoltativo | Fine facoltativa del filtro pubblico sulla data di erogazione, nel formato YYYY-MM-DD; non può precedere start_date. |
results_limit | Facoltativo | Numero 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.
- Indica company, keyword o company_id; combinali solo quando vuoi quella corrispondenza più ristretta definita dalla fonte.
- Aggiungi facoltativamente countries di due lettere, un intervallo di date valido e un results_limit multiplo di 24.
- Invia con POST la richiesta a /v1/linkedin-ad-library/search e salva il task_id restituito.
- 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 trueCasi 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.
API correlate
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.