linkedin-ad-library/
ad

Recupera un singolo record pubblico della LinkedIn Ad Library dal suo URL di dettaglio esatto, con campi normalizzati di inserzionista, creatività, erogazione, destinazione, impression e contenuti multimediali, quando divulgati.

LinkedIn Ad Library Ad API

URL di dettaglio esatto
Divulgazione pubblica degli annunci
Campi di trasparenza nullable
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 Ad

Le pagine di dettaglio della LinkedIn Ad Library sono informazioni pubbliche a durata limitata sugli annunci pubblicati su LinkedIn, con contesto di creatività, inserzionista, erogazione, destinazione, impression e contenuti multimediali quando disponibili. Un record raccolto documenta ciò che era osservabile in quel momento e può diventare parziale o non disponibile al variare di conservazione, restrizioni o condizioni della fonte.

Funzionalità della LinkedIn Ad Library Ad API

  • Risoluzione dell’URL di dettaglio esattoRisolve un URL linkedin.com il cui percorso contiene /ad-library/detail/ in al massimo un record pubblico normalizzato dell’annuncio.
  • Contesto di creatività e inserzionistaConserva, nella forma stabile degli annunci di SocQ, identità dell’annuncio, testo, riferimento all’inserzionista, formato, destinazione e contenuti multimediali disponibili.
  • Divulgazione pubblica dell’erogazioneRestituisce le date di prima e ultima erogazione, i paesi, i posizionamenti e un valore scalare di impression normalizzato in modo sicuro, senza ricostruire il targeting privato.
  • Sicurezza dei record con restrizioniMantiene nullable i valori non disponibili di inserzionista, testo, destinazione, impression o contenuti multimediali, invece di dedurre informazioni trattenute dalla fonte.

Parametri della LinkedIn Ad Library Ad API

ParametriObbligatorioDescrizione
urlObbligatorioURL di dettaglio pubblico obbligatorio della LinkedIn Ad Library. Lo schema deve essere http o https, l’host deve terminare con linkedin.com e il percorso deve contenere /ad-library/detail/.

Come usare la LinkedIn Ad Library Ad API

Invia un URL di dettaglio pubblico esatto della LinkedIn Ad Library, segui l’attività asincrona e leggi il record normalizzato, quando disponibile.

  1. Copia un URL http o https della LinkedIn Ad Library il cui percorso contiene /ad-library/detail/.
  2. Invia con POST url a /v1/linkedin-ad-library/ad e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. Leggi data.results.items; l’operazione di dettaglio restituisce al massimo un record e non trasforma in ricerca un URL non disponibile.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Casi d’uso della LinkedIn Ad Library Ad API

  • Arricchire un annuncio LinkedIn individuato: Recupera i campi disponibili di creatività, inserzionista, erogazione, destinazione, impression e contenuti multimediali per un URL di dettaglio pubblico noto.
  • Conservare un’istantanea della divulgazione: Salva il record normalizzato e il valore collected_at prima che una voce pubblica a durata limitata o con restrizioni cambi o scompaia.
  • Confrontare le prove creative pubbliche: Esamina messaggi, formato, asset e contesto di erogazione divulgato su annunci selezionati, senza trattare il record come dato sulle prestazioni della campagna.

Consigli degli esperti per la LinkedIn Ad Library Ad API

  • Invia l’URL di dettaglio completo e non un semplice ID dell’annuncio, la pagina di un’azienda, un URL di ricerca o un elenco di URL.
  • Distingui un’attività succeeded senza alcun elemento utilizzabile da un errore del provider; nessuno dei due dimostra che l’annuncio non sia mai esistito.
  • Conserva i campi nullable, perché i record con restrizioni o scaduti possono omettere di proposito informazioni su inserzionista, anteprima, pagante, testo, contenuti multimediali o erogazione.
  • Usa LinkedIn Ad Library Search per la scoperta; questa operazione risolve solo l’URL di dettaglio esatto inviato.

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

  • LinkedIn Ad Library Search API — Cerca annunci pubblici di LinkedIn per azienda, ID dell’azienda o parola chiave con controlli su paese, data e numero massimo di risultati.

Esplora altre piattaforme

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

LinkedIn Ad Library Ad API — FAQ

LinkedIn Ad Library Ad API è un’interfaccia programmatica per recuperare un singolo record pubblico della LinkedIn Ad Library dal suo URL di dettaglio esatto. Restituisce campi normalizzati di inserzionista, creatività, erogazione, destinazione, impression e contenuti multimediali quando il record pubblico li espone.

Invia un URL http o https su linkedin.com il cui percorso contiene /ad-library/detail/. ID semplici, pagine di aziende, URL di ricerca ed elenchi di URL non sono accettati.

La fonte può esporre divulgazioni più ricche in alcune regioni, ma la specifica stabile non promette identità del pagante, regole di targeting, ripartizioni delle impression per paese, call to action o stato di restrizione.

L’annuncio può essere stato rimosso, scaduto secondo la finestra di conservazione pubblica, limitato, malformato alla fonte o non disponibile tramite il provider attuale. L’operazione non sostituisce l’annuncio con un altro.

Ogni record restituito costa 0,5 crediti SocQ. Un risultato vuoto riuscito comporta solo il costo base configurato di zero crediti.