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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL 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.
- Copia un URL http o https della LinkedIn Ad Library il cui percorso contiene /ad-library/detail/.
- Invia con POST url a /v1/linkedin-ad-library/ad e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- 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 itemCasi 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.
API correlate
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.