Informazioni su Magileads: Magileads è la tua fonte affidabile di informazioni e risorse preziose. Lo strumento definitivo per una prospezione multicanale di successo. Forniamo contenuti informativi affidabili e ben documentati per tenerti aggiornato e aiutarti a prendere decisioni migliori. Questo contenuto si concentra sull'API Magileads V2 e argomenti correlati.

In breve: l'API Magileads V2 (versione 2.0.0, specifica OpenAPI 3.0) è l'API REST per la piattaforma di prospecting multicanale B2B Magileads. Espone 505 endpoint suddivisi in 47 gruppi, accessibili all'indirizzo https://app.api-magileads.net nell'intestazione x-api-key. Consente di automatizzare l'intero ciclo di generazione dei lead: targeting su LinkedIn, Sales Navigator e Google Maps; arricchimento di email e chiamate telefoniche; campagne email, LinkedIn e SMS; PRM; statistiche; e white labeling.

Questa pagina rappresenta il riferimento completo per l'API Magileads V2. È pensata per sviluppatori, integratori, team di Growth Ops e agenzie che desiderano connettere Magileads al proprio CRM, ai propri strumenti no-code o al proprio back-office, e industrializzare la ricerca di potenziali clienti B2B senza dover passare attraverso l'interfaccia.

L'applicazione è disponibile all'indirizzo application.magileads.io o sul sito web magileads.com.

Specifiche tecniche dell'API Magileads V2

NomeAPI di Magleads
Versione2.0.0
SpecificheFile swagger.json di OpenAPI 3.0 (OAS 3.0).
TipoAPI REST, risposte JSON
URL di basehttps://app.api-magileads.net
Autenticazioneintestazione x-api-key) o OAuth 2.0
Fuso orarioTutte le date sono espresse in GMT
Volume505 endpoint, 47 gruppi: 154 GET, 200 POST, 82 PUT, 69 DELETE
Supportoco*****@*******ds.eu

Distribuzione degli endpoint per dominio funzionale

DominioGruppiPunti terminali
Accesso, autenticazione e sicurezzaInformazioni API, chiavi API, OAuth 2.0, autorizzazioni, ruoli, chiavi API esterne di Magileads V231
Utenti, organizzazioni e abbonamentiUtenti, Organizzazioni, Team, Abbonamenti e Fatturazione, Programmi di affiliazione, Notifiche, Feedback degli utenti73
Individuazione ed estrazione di lead B2BTargeting su LinkedIn e Sales Navigator, targeting su Google Maps, targeting basato su database35
Dati di contatto, arricchimento e conformitàElenchi di contatti, campi dati, arricchimento batch, liste nere, utenti che si disiscrivono, tag60
Messaggi, modelli e agenti di intelligenza artificialeAgenti IA, modelli di email, modelli di invito LinkedIn, modelli di messaggio LinkedIn, modelli SMS, modelli SMV, firme email62
Campagne multicanale (flussi di lavoro)Flussi di lavoro e pianificazione, Lavori, Pool di integrazione, Accorciatore di URL, Moduli62
Canali di invio e recapitoIntegrazioni email, integrazioni con LinkedIn, OVH (domini ed email)33
PRM: CRM per la ricerca di potenziali clientiPRM57
Statistiche e reportisticaStatistiche, Rapporti26
Automazione e integrazioni con terze partiWebhook, Zapier, Cron22
Etichetta bianca (rivenditori)Rivenditori, Rivenditori: Mailgun33
File e cartelleFile, cartelle11

Autenticazione API Magileads V2

Coesistono due meccanismi:

  • Chiave API intestazione x-api-key. Le chiavi vengono gestite tramite l'API (/api-keys): generazione, rigenerazione ed eliminazione. Questo metodo è adatto per script lato server e integrazioni interne.
  • OAuth 2.0 : per applicazioni di terze parti che agiscono per conto di un utente. Il server di autorizzazione viene individuato tramite GET /.well-known/oauth-authorization-server e supporta lo streaming del codice di autorizzazione, la registrazione dinamica del client, l'aggiornamento del token e la revoca del token.

Buona prassi di sicurezza: la chiave API garantisce l'accesso a tutti i dati dell'account. Non esporla mai nel browser, in un URL condiviso o in un repository di codice. In caso di violazione, rigenerala immediatamente con PUT /api-keys/{api_key_id}/regenerate.

Avvio rapido: prima chiamata

La prima chiamata consigliata è GET /users/me, che restituisce il profilo dell'account associato alla chiave e convalida la configurazione.

Con cURL

curl -X GET "https://app.api-magileads.net/users/me" \ -H "accept: application/json" \ -H "x-api-key: YOUR_API_KEY"

In PHP (WordPress)

<?php declare(strict_types=1); /** * Récupère le profil du compte Magileads associé à la clé d’API. * La clé est lue depuis une constante définie dans wp-config.php, jamais en base ni en dur. * * @return array<string, mixed> |WP_Error */ function magileads_get_my_profile(): array|WP_Error { if ( ! defined( 'MAGILEADS_API_KEY' ) ) { return new WP_Error( 'magileads_no_key', 'Costante MAGILEADS_API_KEY mancante.' ); } $response = wp_remote_get( 'https://app.api-magileads.net/users/me', array( 'timeout' => 15, 'headers' => array( 'Accept' => 'application/json', 'x-api-key' => (string) MAGILEADS_API_KEY, ), ) ); if ( is_wp_error( $response ) ) { return $response; } $code = (int) wp_remote_retrieve_response_code( $response ); if ( 200 !== $code ) { return new WP_Error( 'magileads_http_' . $code, 'Risposta HTTP inattesa.' ); } $data = json_decode( wp_remote_retrieve_body( $response ), true ); return is_array( $data ) ? $data: new WP_Error('magileads_json', 'JSON non valido.'); }

Utilizzo di JavaScript (Node.js, solo lato server)

// Chiamata lato server: la chiave rimane in una variabile d'ambiente. const res = await fetch("https://app.api-magileads.net/users/me", { headers: { accept: "application/json", "x-api-key": process.env.MAGILEADS_API_KEY } }); if (!res.ok) throw new Error(`API Magileads: HTTP ${res.status}`); const profile = await res.json();

Casi d'uso dell'API Magileads V2

1. Costruisci un pubblico B2B qualificato

endpoint Targeting – LinkedIn, Targeting – Google e Targeting – Database popolano gli elenchi di contatti a partire dalle ricerche di Sales Navigator, dalle interazioni sui post di LinkedIn, dai visitatori del profilo o dagli elenchi di Google Maps.

2. Arricchire e pulire i dati

I pacchetti di arricchimento e gli endpoint di arricchimento per email e dispositivi mobili completano i record. Le blacklist e le richieste di disiscrizione vengono applicate direttamente agli elenchi per conformarsi al GDPR prima di qualsiasi invio.

3. Avvia sequenze multicanale personalizzate basate sull'intelligenza artificiale

I modelli di email , gli inviti e i messaggi di LinkedIn vengono generati dall'intelligenza artificiale e poi assemblati in un flusso di lavoro , programmato su account di invio raggruppati in pool con preriscaldamento SMTP.

4. Elaborare le risposte nel PRM

Il PRM centralizza i rispondenti: qualificazione positiva o negativa, suggerimenti di risposta basati sull'intelligenza artificiale, note, chiamate, stati personalizzati e attività di nurturing.

5. Misurare e sincronizzare

Le statistiche analizzano i partecipanti al sondaggio per settore, dimensione aziendale, paese o canale. Webhook e Zapier inviano eventi al CRM.

Riferimento completo agli endpoint 505 dell'API Magileads V2

Gli endpoint sono raggruppati per dominio funzionale. I segmenti tra parentesi graffe (ad esempio, {contact_list_id}) sono parametri di percorso. {file_type} indica il formato di esportazione richiesto. Le descrizioni utilizzano le etichette ufficiali della specifica OpenAPI.

Accesso, autenticazione e sicurezza

Punti di accesso che controllano l'accesso all'API: chiavi API, server di autorizzazione OAuth 2.0, ruoli, permessi e chiavi API di servizi di terze parti. 31 endpoint.

Informazioni API

Restituisce i metadati dell'API, a livello globale o per un determinato dominio SaaS (istanza white-label). 2 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/apiInformazioni API
OTTENERE/api/{dominio_saas}Informazioni API

Chiavi API

Ciclo di vita completo delle chiavi API (token): generazione, aggiornamento, rigenerazione e revoca. La rigenerazione invalida la vecchia chiave. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/chiavi-APIRecupera elenco
OTTENERE/api-keys/{api_key_id}Trova il profilo
INVIARE/chiavi-APIGenera una chiave API (token)
METTERE/api-keys/{api_key_id}Aggiorna il profilo
METTERE/api-keys/{api_key_id}/regenerateRigenera una chiave API (token)
ELIMINARE/api-keys/{api_key_id}Eliminare una chiave API

OAuth 2.0 OAuth

Server di autorizzazione conforme a OAuth 2.0: rilevamento tramite /.well-known/oauth-authorization-server, flusso di codice di autorizzazione, registrazione dinamica del client, scambio e aggiornamento del token, revoca e chiavi di firma JWKS. 8 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/well-known/oauth-authorization-serverScopri il server di autorizzazione OAuth
OTTENERE/oauth/authorization-transactions/{transaction_id}Recupera una transazione di consenso OAuth
OTTENERE/oauth/authorizeAvvia un flusso di codice di autorizzazione
OTTENERE/oauth/jwks.jsonRecupera le chiavi di firma OAuth
INVIARE/oauth/authorization-transactions/{transaction_id}Approva o nega una transazione di consenso OAuth
INVIARE/oauth/registrazioneRegistra un client OAuth in modo dinamico
INVIARE/oauth/revocaRevoca un token OAuth
INVIARE/oauth/tokenScambia o aggiorna i token OAuth

Permessi Permessi

Lettura e modifica, singolarmente o in blocco, delle autorizzazioni concesse a ciascun utente. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/autorizzazioniRecupera elenco
OTTENERE/permessi/{user_id}Recupera l'elenco di un utente
METTERE/permessi/{nome_permesso}/{ID_utente}Aggiornare un permesso utente
METTERE/permessi/{user_id}Aggiornamento in blocco delle autorizzazioni utente
ELIMINARE/permessi/{nome_permesso}/{ID_utente}Elimina un'autorizzazione

Ruoli Roles

Creazione e gestione di ruoli che raggruppano i diritti degli utenti. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/ruoliRecupera elenco
OTTENERE/ruoli/{ID_ruolo}Trova il profilo
INVIARE/ruoliCrea un ruolo
METTERE/ruoli/{ID_ruolo}Aggiorna il profilo
ELIMINARE/ruoli/{ID_ruolo}Elimina un ruolo

Chiavi API esterne

Archiviazione delle chiavi di servizio di terze parti (fornitori di arricchimento, OVH, ecc.) successivamente utilizzate da altri endpoint tramite {external_api_key_id}. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/chiavi-API-esterneRecupera elenco
OTTENERE/external-api-keys/{external_api_key_id}Trova il profilo
INVIARE/chiavi-API-esterneAggiungi profilo
METTERE/external-api-keys/{external_api_key_id}Aggiorna il profilo
ELIMINARE/external-api-keys/{external_api_key_id}Elimina profilo

Utenti, organizzazioni e abbonamenti

Gestione degli account utente, gestione dell'organizzazione, gestione dei team, gestione della fatturazione e gestione delle notifiche. 73 endpoint.

Utenti Users

Registrazione, autenticazione (con aggiornamento), accesso tramite provider di terze parti, profilo corrente (/users/me), avatar, password, verifica tramite SMS, passaggio tra account e generazione di un token di ricerca incorporato. 26 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/users/{user_id}Trova il profilo tramite ID
OTTENERE/users/listRecupera l'elenco degli utenti
OTTENERE/utenti/meTrova il mio profilo
OTTENERE/utenti/io/veloceTrova il mio profilo (versione rapida)
INVIARE/oauth/{provider}/redirectRegistrati o accedi utilizzando credenziali di terze parti
INVIARE/users/{user_id}/avatarCarica un avatar su un account utente
INVIARE/utenti/autenticazioneAutenticazione
INVIARE/utenti/autenticazione/aggiornamentoAutenticazione aggiornata
INVIARE/users/list/searchUtenti di ricerca
INVIARE/users/me/avatarCarica un avatar sul mio account utente
INVIARE/users/me/embed/search-list/tokenGenera un token di ricerca incorporato
INVIARE/utenti/registrazioneRegistro
INVIARE/users/switch/to/{user_id}Passa a un account utente
INVIARE/users/verification/sms/resendReinvia il codice di verifica via SMS
METTERE/users/{user_id}Aggiorna il profilo tramite ID
METTERE/users/{user_id}/disableDisabilita tramite ID
METTERE/utenti/meAggiorna il mio profilo
METTERE/users/me/disableDisabilita
METTERE/users/password/forgotHa dimenticato la password
METTERE/users/password/resetReimposta la password
METTERE/utenti/sbloccaSblocca l'account utente
METTERE/utenti/verifica/sms/confermaConferma l'account tramite codice SMS
ELIMINARE/users/{user_id}Eliminare un account utente
ELIMINARE/users/{user_id}/avatarEliminare l'avatar di un account utente
ELIMINARE/utenti/meElimina il mio account utente
ELIMINARE/users/me/avatarElimina l'avatar dal mio account utente

Organizzazioni Organizations

Creazione dell'organizzazione, invito e iscrizione degli utenti, gestione dei livelli e dei ruoli dei membri. 11 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/organizzazioniRecupera elenco
OTTENERE/organizzazioni/{organization_id}Trova il profilo
OTTENERE/organizzazioni/{organization_id}/utentiRecupera l'elenco degli utenti
INVIARE/organizzazioniCreare un'organizzazione
INVIARE/organizzazioni/{organization_id}/invitoInvitare un utente a un'organizzazione
INVIARE/organizzazioni/unirsiUnisciti a un'organizzazione
METTERE/organizzazioni/{organization_id}Aggiorna il profilo
METTERE/organizzazioni/{organization_id}/livello/{user_id}Aggiorna il livello dell'utente
METTERE/organizzazioni/{organization_id}/ruolo/{user_id}Aggiornare il ruolo di un utente
ELIMINARE/organizzazioni/{organization_id}Elimina un'organizzazione
ELIMINARE/organizzazioni/{organization_id}/lasciaLascia un'organizzazione

Squadre Teams

Team all'interno di un account: inviti, appartenenza, livelli di appartenenza e ruoli. 10 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/teams/{team_id}Trova il profilo
OTTENERE/teams/{team_id}/usersRecupera l'elenco degli utenti
INVIARE/squadreCrea una squadra
INVIARE/teams/{team_id}/inviteInvita un utente a un team
INVIARE/teams/joinUnisciti a una squadra
METTERE/teams/{team_id}Aggiorna il profilo
METTERE/teams/{team_id}/level/{user_id}Aggiorna il livello dell'utente
METTERE/teams/{team_id}/role/{user_id}Aggiornare il ruolo di un utente
ELIMINARE/teams/{team_id}Elimina una squadra
ELIMINARE/teams/{team_id}/leaveLascia una squadra

Abbonamenti e fatturazione

Prodotti, abbonamento e cancellazione, opzioni di abbonamento, metodi di pagamento, informazioni sul cliente e download delle fatture. 12 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/abbonamenti/fattureRecupera l'elenco delle fatture dei clienti
OTTENERE/abbonamenti/fatture/download/{id_fattura}Scarica la fattura del cliente
OTTENERE/abbonamenti/prodottiVisualizza l'elenco dei prodotti
INVIARE/abbonamenti/aggiungi/metodo-di-pagamentoAggiungi e imposta il metodo di pagamento predefinito
INVIARE/abbonamenti/iscrivitiIscriviti
INVIARE/abbonamenti/iscriviti/{user_id}Iscriviti
INVIARE/abbonamenti/aggiornamento/informazioni-clientiAggiorna le informazioni del cliente
INVIARE/abbonamenti/aggiornamento/metodo-di-pagamento-predefinitoAggiorna il metodo di pagamento predefinito
METTERE/abbonamenti/aggiungi/opzioniAggiungi opzioni di abbonamento
ELIMINARE/abbonamenti/rimuovi/opzioniRimuovi le opzioni di abbonamento
ELIMINARE/abbonamenti/annulla iscrizioneAnnulla iscrizione
ELIMINARE/abbonamenti/annulla iscrizione/{user_id}Annulla iscrizione

Affiliazione Affiliazione

Elenco degli utenti associati al programma di affiliazione. 1 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/affiliazione/utentiRecupera l'elenco degli utenti

Notifiche Notifications

Notifiche e avvisi relativi all'account: conferme di lettura, indicazione di letto/non letto, possibilità di nascondere le notifiche e impostazioni di notifica. 12 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/notificheRecupera le notifiche
OTTENERE/notifiche/avvisiRicevi avvisi sull'account
OTTENERE/notifiche/impostazioniRecupera le impostazioni di notifica
METTERE/notifiche/avvisi/nascondiNascondi un avviso sull'account
METTERE/notifiche/avvisi/mostraMostra un avviso sull'account
METTERE/notifiche/nascondiNascondi le notifiche
METTERE/notifiche/nascondi tuttoNascondi tutte le notifiche
METTERE/notifiche/letteContrassegna le notifiche come lette
METTERE/notifiche/leggi tuttoContrassegna tutte le notifiche come lette
METTERE/notifiche/impostazioniAggiorna le impostazioni di notifica
METTERE/notifiche/mostraMostra le notifiche
METTERE/notifiche/non letteContrassegna le notifiche come non lette

Feedback degli utenti

Invio del feedback al team di Magileads. 1 endpoint.

MetodoPunto finaleDescrizione
INVIARE/feedbackInvia feedback

Individuazione ed estrazione di lead B2B

Generazione di lead: estrazione di contatti e aziende da LinkedIn, Sales Navigator, Google Maps e dal database Magileads. 35 endpoint.

Targeting su LinkedIn e targeting di Sales Navigator – LinkedIn

Estrazione di profili e aziende da ricerche su LinkedIn e Sales Navigator (modalità asincrona, sincrona e alternativa), connessioni, membri di gruppi, partecipanti a eventi, visitatori di pagine di profili o aziende, interazioni con i post (mi piace, commenti, condivisioni), attività del profilo e offerte di lavoro. Include la generazione di URL di ricerca e il recupero dell'ID di posizione. 27 endpoint.

MetodoPunto finaleDescrizione
INVIARE/targeting/linkedin/{contact_list_id}/errori di riavvioRiavviare le estrazioni di LinkedIn con errori
INVIARE/targeting/linkedin/extract-companies-search-syncEstrazione di aziende LinkedIn da una ricerca aziendale (sincrona)
INVIARE/targeting/linkedin/extract-company-viewersEstrazione dei visualizzatori aziendali di LinkedIn
INVIARE/targeting/linkedin/extract-connectionsEstrai i contatti dalle connessioni di LinkedIn
INVIARE/targeting/linkedin/extract-event-attendeesEstrazione dei partecipanti all'evento LinkedIn
INVIARE/targeting/linkedin/extract-group-membersEstrarre i membri del gruppo LinkedIn
INVIARE/targeting/linkedin/extract-people-comment-activityEstrazione dei commenti degli utenti di LinkedIn
INVIARE/targeting/linkedin/extract-people-post-activityEstrarre l'attività dei post degli utenti di LinkedIn
INVIARE/targeting/linkedin/extract-people-reaction-activityEstrazione delle interazioni degli utenti di LinkedIn
INVIARE/targeting/linkedin/extract-peoples-searchEstrarre contatti da una ricerca su LinkedIn
INVIARE/targeting/linkedin/extract-peoples-search-alternativeEstrarre i contatti da una ricerca su LinkedIn (alternativa)
INVIARE/targeting/linkedin/extract-peoples-search-syncEstrazione di profili LinkedIn da una ricerca di persone (sincrona)
INVIARE/targeting/linkedin/extract-post-commentersEstrai i contatti che hanno commentato un post di LinkedIn
INVIARE/targeting/linkedin/extract-post-likersEstrai i contatti a cui è piaciuto un post su LinkedIn
INVIARE/targeting/linkedin/extract-post-repostersEstrazione dei post ripubblicati da LinkedIn
INVIARE/targeting/linkedin/extract-postsEstrarre post da LinkedIn
INVIARE/targeting/linkedin/extract-posts-syncEstrazione dei post di LinkedIn (sincrona)
INVIARE/targeting/linkedin/extract-profile-viewersVisualizzatori di profili LinkedIn
INVIARE/targeting/linkedin/extract-publishers-job-offersEstrai gli autori delle offerte di lavoro su LinkedIn
INVIARE/targeting/linkedin/extract-sales-navigator-companies-searchEstrarre aziende da una ricerca di Sales Navigator
INVIARE/targeting/linkedin/extract-sales-navigator-companies-search-alternativeEstrarre aziende da una ricerca di Sales Navigator (alternativa)
INVIARE/targeting/linkedin/extract-sales-navigator-peoples-searchEstrarre i contatti da una ricerca di Sales Navigator
INVIARE/targeting/linkedin/extract-sales-navigator-peoples-search-alternativeEstrarre i contatti da una ricerca di Sales Navigator (alternativa)
INVIARE/targeting/linkedin/generate-peoples-search-urlGenera un URL di ricerca persone su LinkedIn
INVIARE/targeting/linkedin/generate-sales-navigator-peoples-search-urlGenera un URL di ricerca persone di LinkedIn Sales Navigator
INVIARE/ricerca/localizzazioni/di/targeting/linkedinCerca gli ID di posizione di LinkedIn
INVIARE/targeting/linkedin/refresh/{contact_list_id}Aggiorna il targeting di LinkedIn su un elenco di contatti

Targeting di Google Maps Targeting – Google

Estrazione di aziende e contatti dalle ricerche su Google Maps, generazione di URL di ricerca e recupero delle estrazioni (incluse quelle con errori). 4 endpoint.

MetodoPunto finaleDescrizione
INVIARE/targeting/google/extract-maps-searchEstrarre i contatti da una ricerca su Google Maps
INVIARE/targeting/google/extract-maps-search/{contact_list_id}/relaunchRiavviare le estrazioni
INVIARE/targeting/google/extract-maps-search/{contact_list_id}/relaunch-errorsRiavvia le estrazioni con errori
INVIARE/targeting/google/generate-maps-search-urlsGenera URL di ricerca di Google Maps

Targeting del database

Conteggio, anteprima ed estrazione dei contatti dal database Magileads tramite filtri, con ricerca per posizione. 4 endpoint.

MetodoPunto finaleDescrizione
INVIARE/targeting/database/countConta il numero di contatti trovati con i filtri specificati
INVIARE/targeting/database/count-previewVisualizza in anteprima e conteggia i contatti in base ai filtri
INVIARE/targeting/database/extractEstrai i contatti trovati con i filtri specificati
INVIARE/ricerca/del/database/di/localizzazioni/di/targetingRicerca posizione nel database

Dati di contatto, arricchimento e conformità

Archiviazione, strutturazione e arricchimento dei contatti, oltre alle liste di esclusione essenziali per la conformità al GDPR. 60 endpoint.

Liste di contatti

Elenchi di contatti e singoli contatti: impaginazione, ricerca incrociata, unione, esportazione per tipo di file, valori univoci e aggiornamenti di campo in blocco. Pulizia avanzata: rimozione di contatti da una blacklist, da un altro elenco o da contatti che si sono disiscritti, e limitazione del numero di contatti per azienda. Arricchimento di email e dispositivi mobili. 26 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/liste-contattiRecupera tutti gli elenchi
OTTENERE/liste-contatti-paginateRecupera elenco paginato
OTTENERE/liste-contatti/{ID_lista_contatti}Trova il profilo
OTTENERE/liste_contatti/{ID_lista_contatti}/contattiRecupera i contatti
OTTENERE/liste_contatti/{id_lista_contatti}/contatti/{id_contatto}Trova il profilo del contatto
OTTENERE/liste-contatti/{contact_list_id}/campi_dati/{datafield_id}/valoriOttenere valori univoci da un campo dati
OTTENERE/liste_contatti/{ID_lista_contatti}/scarica/{tipo_file}Scarica l'elenco dei contatti
OTTENERE/liste-contatti/nomiRecupera gli ID e i nomi dell'elenco contatti
INVIARE/liste-contatti/contatti/ricercaCerca contatti in tutta la lista contatti
INVIARE/liste-contatti/scarica/{tipo_file}Scarica l'elenco dei contatti da tutti gli elenchi di contatti
INVIARE/liste-contatti/unioneUnisci gli elenchi di contatti
INVIARE/contatti/arricchisci/emailArricchisci un indirizzo email di contatto dall'azienda e dai nomi facoltativi
INVIARE/contatti/arricchisci/telefono/cellulareArricchisci un contatto di cellulare dall'URL di LinkedIn
METTERE/liste-contatti/{ID_lista_contatti}Aggiorna il profilo
METTERE/liste_contatti/{id_lista_contatti}/contatti/{id_contatto}Aggiorna il contatto
METTERE/liste-contatti/{contact_list_id}/campi_dati/{datafield_id}/insieme-bulkValore del campo dati del set di dati in blocco
ELIMINARE/liste-contatti/{ID_lista_contatti}Eliminare un elenco di contatti
ELIMINARE/liste_contatti/{ID_lista_contatti}/contattiEliminare i contatti da un elenco di contatti
ELIMINARE/liste_contatti/{id_lista_contatti}/contatti/{id_contatto}Elimina contatto
ELIMINARE/liste-contatti/{id_lista_contatti}/contatti/lista_nera/{id_lista_nera}Eliminare i contatti da un elenco di contatti trovato in una blacklist
ELIMINARE/liste-contatti/{id_lista_contatti}/contatti/lista-contatti/{id_lista_contatti_origine}Eliminare i contatti da un elenco di contatti presente in un altro elenco di contatti
ELIMINARE/liste_contatti/{ID_lista_contatti}/contatti/cancellatoriElimina i contatti da un elenco di contatti trovato in chi ha annullato l'iscrizione
ELIMINARE/liste_contatti/{ID_lista_contatti}/contatti/cancellazioni/{ID_organizzazione}Elimina i contatti da un elenco di contatti trovato tra gli utenti che si sono disiscritti da un'organizzazione
ELIMINARE/liste_contatti/{ID_lista_contatti}/elimina/azienda/{mantieni_contatti}Elimina i contatti da un elenco contatti per conservare solo un certo numero di contatti per azienda
ELIMINARE/liste-contatti/contattiElimina contatti
ELIMINARE/liste-contatti/contatti/selezioneEliminare i contatti da una selezione

Campi dati

Campi personalizzati (campi dati) associati ai contatti. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/campi-datiRecupera elenco
OTTENERE/data-fields/{data_field_id}Trova il profilo
INVIARE/campi-datiCrea un campo dati
METTERE/data-fields/{data_field_id}Aggiorna il profilo
ELIMINARE/data-fields/{data_field_id}Elimina un campo dati

Arricchimento del lotto

Creazione di lotti di arricchimento, recupero dei risultati e statistiche di consumo. 3 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/enrich/{batch_id}Ottieni risultati batch arricchiti
INVIARE/arricchireCreare un batch arricchito
INVIARE/arricchire/l'utilizzoOttieni statistiche di utilizzo più dettagliate

Liste nere Blacklists

Liste di esclusione: creazione, importazione dati, ricerca mirata o globale, download (con o senza filtro) ed eliminazione dati. 13 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/liste nereRecupera elenco
OTTENERE/blacklists/{blacklist_id}Trova il profilo
OTTENERE/blacklists/{blacklist_id}/dataRecupera i dati
OTTENERE/blacklists/{blacklist_id}/download/{file_type}Scarica la lista nera
INVIARE/liste nereCrea una lista nera
INVIARE/blacklists/{blacklist_id}/dataImporta dati
INVIARE/blacklists/{blacklist_id}/data/searchRicerca dati in una specifica blacklist
INVIARE/blacklists/{blacklist_id}/download/{file_type}Scarica la blacklist utilizzando un filtro
INVIARE/blacklists/data/searchRicerca dati in tutte le blacklist
METTERE/blacklists/{blacklist_id}Aggiorna il profilo
ELIMINARE/blacklists/{blacklist_id}Eliminare una lista nera
ELIMINARE/blacklists/{blacklist_id}/data/{data_id}Elimina i dati
ELIMINARE/liste nere/datiElimina i dati

Utenti che si disiscrivono Unsubscribers

Gestione globale o organizzativa delle disiscrizioni: importazione, ricerca, download ed eliminazione. 8 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/disiscrittiRecupera gli utenti che si sono disiscritti
OTTENERE/unsubscribers/download/{file_type}Scarica l'elenco degli utenti che si sono disiscritti
OTTENERE/unsubscribers/organization/{organization_id}Recuperare gli utenti che si sono disiscritti da un'organizzazione
OTTENERE/unsubscribers/organization/{organization_id}/download/{file_type}Scarica l'elenco degli utenti che si sono disiscritti da un'organizzazione
INVIARE/disiscrittiImporta disiscritti
INVIARE/unsubscribers/organization/{organization_id}/searchCerca gli utenti che si sono disiscritti da una specifica organizzazione
INVIARE/ricerca utenti che hanno annullato l'iscrizioneCerca gli utenti che si sono disiscritti da tutte le organizzazioni
ELIMINARE/disiscritti/{ID_disiscrizione}Eliminare un utente che si è disiscritto

Etichette Etichette

Etichette riutilizzabili per la segmentazione dei contatti. 5 punti di connessione.

MetodoPunto finaleDescrizione
OTTENERE/tagRecupera elenco
OTTENERE/tags/{tag_id}Trova il profilo
INVIARE/tagCrea un tag
METTERE/tags/{tag_id}Aggiorna il profilo
ELIMINARE/tags/{tag_id}Elimina un tag

Messaggi, modelli e agenti di intelligenza artificiale

Modelli di messaggio per ciascun canale e agenti IA incaricati di scrivere e personalizzare i contenuti della campagna. 62 endpoint.

Agenti di intelligenza artificiale (AiAgents)

Creazione e gestione di agenti IA, generazione di un brief a partire da un agente esistente o senza agente. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/ai-agentsRecupera gli agenti IA
OTTENERE/ai-agents/{uniqid}Trova l'agente IA di Uniqid
INVIARE/ai-agentsCrea un agente di intelligenza artificiale
INVIARE/ai-agents/{uniqid}/generate-briefGenera il brief dell'agente AI
INVIARE/ai-agents/generate-briefGenerare un brief per un agente IA senza un agente esistente
METTERE/ai-agents/{uniqid}Aggiorna l'agente AI
ELIMINARE/ai-agents/{uniqid}Elimina l'agente AI

Modelli di email – Email

Modelli di email: generazione e rigenerazione basate sull'intelligenza artificiale (testo e HTML), personalizzazione per contatto, importazione di HTML da URL, copia tra account e invio di email di prova. 15 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/modelli/emailRecupera elenco
OTTENERE/models/email/{model_id}Trova il profilo
OTTENERE/models/email/{model_id}/{contact_id}Trova il profilo del modello di IA e genera contenuti
OTTENERE/models/email/{model_id}/{contact_id}/regenerateTrova il profilo del modello AI e rigenera il contenuto
INVIARE/modelli/emailCrea un modello di email
INVIARE/models/email/{model_id}/copyCopia un modello di email
INVIARE/models/email/{model_id}/copy/to/{user_id}Copia il modello di email all'ID utente
INVIARE/models/email/{model_id}/regenerateRigenerare un modello di email utilizzando l'intelligenza artificiale
INVIARE/models/email/{model_id}/send/testInvia una campagna email utilizzando i tuoi indirizzi email di prova
INVIARE/modelli/email/generateGenera un modello di email utilizzando l'intelligenza artificiale
INVIARE/modelli/email/genera/htmlGenera email in HTML utilizzando l'intelligenza artificiale
INVIARE/models/email/get/html/from/urlOttieni l'HTML dall'URL
INVIARE/modelli/email/invio/testInvia una campagna email utilizzando le tue email di prova senza creare un modello
METTERE/models/email/{model_id}Aggiorna un modello di email
ELIMINARE/models/email/{model_id}Elimina un modello di email

Modelli di invito LinkedIn – Invito LinkedIn

Modelli di richiesta di connessione LinkedIn, con generazione di contenuti basata sull'intelligenza artificiale e personalizzazione per ogni contatto. 10 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/modelli/linkedin/invitoRecupera elenco
OTTENERE/models/linkedin/invito/{model_id}Trova il profilo
OTTENERE/models/linkedin/invitation/{model_id}/{contact_id}Trova il profilo del modello di IA e genera contenuti
OTTENERE/models/linkedin/invitation/{model_id}/{contact_id}/regenerateTrova il profilo del modello AI e rigenera il contenuto
INVIARE/modelli/linkedin/invitoCrea un invito su LinkedIn
INVIARE/models/linkedin/invitation/{model_id}/copyCopia un invito di LinkedIn
INVIARE/models/linkedin/invito/{model_id}/copia/a/{user_id}Copia un invito di LinkedIn all'ID utente
INVIARE/models/linkedin/invito/genera/contenutoGenera contenuti di invito su LinkedIn utilizzando l'intelligenza artificiale
METTERE/models/linkedin/invito/{model_id}Aggiorna un invito su LinkedIn
ELIMINARE/models/linkedin/invito/{model_id}Elimina un invito di LinkedIn

Modelli di messaggi LinkedIn – Messaggi LinkedIn

Modelli di messaggi LinkedIn con generazione di contenuti basata sull'intelligenza artificiale e personalizzazione per ogni contatto. 10 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/models/linkedin/messageRecupera elenco
OTTENERE/models/linkedin/message/{model_id}Trova il profilo
OTTENERE/models/linkedin/message/{model_id}/{contact_id}Trova il profilo del modello di IA e genera contenuti
OTTENERE/models/linkedin/message/{model_id}/{contact_id}/regenerateTrova il profilo del modello AI e rigenera il contenuto
INVIARE/models/linkedin/messageCrea un messaggio su LinkedIn
INVIARE/models/linkedin/message/{model_id}/copyCopia un messaggio di LinkedIn
INVIARE/models/linkedin/message/{model_id}/copy/to/{user_id}Copia un messaggio LinkedIn all'ID utente
INVIARE/models/linkedin/message/generate/contentGenera contenuti per messaggi LinkedIn utilizzando l'intelligenza artificiale
METTERE/models/linkedin/message/{model_id}Aggiorna un messaggio su LinkedIn
ELIMINARE/models/linkedin/message/{model_id}Elimina un messaggio di LinkedIn

Modelli SMS – SMS

Modelli SMS: creazione, copia (anche verso un altro utente), aggiornamento ed eliminazione. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/modelli/smsRecupera elenco
OTTENERE/models/sms/{model_id}Trova il profilo
INVIARE/modelli/smsCreare un modello SMS
INVIARE/models/sms/{model_id}/copyCopia un modello di SMS
INVIARE/models/sms/{model_id}/copy/to/{user_id}Copia un modello SMS nell'ID utente
METTERE/models/sms/{model_id}Aggiornare un modello SMS
ELIMINARE/models/sms/{model_id}Elimina un modello SMS

Modelli SMV – SMV

Modelli SMV: creazione, aggiornamento, copia (anche verso un altro utente) ed eliminazione. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/modelli/smvRecupera elenco
OTTENERE/models/smv/{model_id}Trova il profilo
INVIARE/modelli/smvCreare un modello SMV
INVIARE/models/smv/{model_id}Aggiornare un modello SMV
INVIARE/models/smv/{model_id}/copyCopia un modello SMV
INVIARE/models/smv/{model_id}/copy/to/{user_id}Copia un modello SMV nell'ID utente
ELIMINARE/models/smv/{model_id}Eliminare un modello SMV

Firme e-mail Firme e-mail

Firme email riutilizzabili nelle campagne. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/firme-emailRecupera elenco
OTTENERE/email-signatures/{email_signature_id}Trova il profilo
INVIARE/firme-emailCrea una firma email
INVIARE/email-signatures/{email_signature_id}/copyCopia la firma email
METTERE/email-signatures/{email_signature_id}Aggiorna il profilo
ELIMINARE/email-signatures/{email_signature_id}Elimina la firma email

Campagne multicanale (flussi di lavoro)

Orchestrazione di sequenze di prospezione multicanale e loro esecuzione. 62 endpoint.

Flussi di lavoro e pianificazione

Automazione di base: creazione, copia e pianificazione di flussi di lavoro, controllo delle pianificazioni (arresto, ripresa, archiviazione, passo passo), contatti per passo e per tipo (esportazione, copia in un elenco, aggiunta alla blacklist), clicker tramite link, esclusioni, invio di email individuali, download di EML e generazione di flussi di lavoro tramite agente AI (attività, anteprima, valutazione della prontezza, rigenerazione). 39 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/flussi di lavoroRecupera elenco
OTTENERE/workflows/{workflow_id}Trova il profilo
OTTENERE/workflows/{workflow_id}/programming/{workflow_programming_id}Trova un flusso di lavoro di programmazione
OTTENERE/flussi di lavoro/{id_flusso_di_lavoro}/programmazione/{id_programmazione_flusso_di_lavoro}/{tipo_contatto}Ottieni i contatti tramite programmazione del flusso di lavoro e tipo
OTTENERE/flussi di lavoro/{id_flusso_di_lavoro}/programmazione/{id_programmazione_flusso_di_lavoro}/passaggio/{id_passaggio}/{tipo_contatto}Ottieni i contatti in base alla fase di programmazione del flusso di lavoro e al tipo
OTTENERE/workflows/{workflow_id}/programmazione/{workflow_programming_id}/step/{step_id}/click/link/{link_url}Ottieni i contatti del clicker tramite la fase di programmazione del flusso di lavoro, il tipo e il collegamento
OTTENERE/workflows/{workflow_id}/programmazioneRecupera le pianificazioni del flusso di lavoro tramite ID del flusso di lavoro
OTTENERE/workflows/ai-agent/jobsRecupera i lavori di generazione del flusso di lavoro dell'agente AI
OTTENERE/workflows/ai-agent/jobs/{job_uniqid}Recupera lo stato di generazione del flusso di lavoro dell'agente AI
OTTENERE/workflows/exclude/programmazione/{programmazione_id}Elenco delle esclusioni dei contatti da una programmazione
OTTENERE/flussi di lavoro/programmazioniRecupera le pianificazioni del flusso di lavoro
OTTENERE/flussi di lavoro/programmi/contattiRecupera il flusso di lavoro, contatta la programmazione
OTTENERE/workflows/reply/email/{reply_id}/download/emlScarica l'eml di una risposta via email
OTTENERE/workflows/inviato/email/{id}/scarica/emlScarica l'eml di un'email inviata manualmente
INVIARE/flussi di lavoroCreare un flusso di lavoro
INVIARE/workflows/{workflow_id}/copyCopia un flusso di lavoro
INVIARE/workflows/{workflow_id}/copy/to/{user_id}Copia un flusso di lavoro all'ID utente
INVIARE/workflows/{workflow_id}/immagineCarica l'immagine del flusso di lavoro
INVIARE/workflows/{workflow_id}/programmaProgrammare un flusso di lavoro
INVIARE/flussi di lavoro/{id_flusso_di_lavoro}/programmazione/{id_programmazione_flusso_di_lavoro}/{tipo_contatto}/{tipo_file}Scarica i contatti tramite programmazione del flusso di lavoro e tipo
INVIARE/flussi di lavoro/{id_flusso_di_lavoro}/programmazione/{id_programmazione_flusso_di_lavoro}/passaggio/{id_passaggio}/{tipo_contatto}/{tipo_file}Scarica i contatti in base alla fase di programmazione del flusso di lavoro e al tipo
INVIARE/workflows/{workflow_id}/programming/{workflow_programming_id}/step/{step_id}/{contact_type}/blacklist/{blacklist_id}Lista nera dei contatti in base alla fase di programmazione del flusso di lavoro e al tipo
INVIARE/workflows/{workflow_id}/programming/{workflow_programming_id}/step/{step_id}/{contact_type}/copy-to/{contact_list_id_destination}Copia i contatti di una fase di programmazione del flusso di lavoro e inseriscili in un elenco contatti
INVIARE/workflows/{workflow_id}/readinessValutare la predisposizione al flusso di lavoro dell'agente di intelligenza artificiale
INVIARE/workflows/ai-agentGenerazione della bozza del flusso di lavoro dell'agente AI in coda
INVIARE/workflows/ai-agent/jobs/{job_uniqid}/contact-previewGenera anteprime di contatto raggruppate degli agenti IA
INVIARE/workflows/ai-agent/regenerateRigenerare un messaggio o un flusso di lavoro di una campagna basata sull'IA
INVIARE/workflows/invia/emailInvia una singola email
INVIARE/workflows/invia/email-con-allegatiInvia una singola email con allegati
METTERE/workflows/{workflow_id}Aggiorna il profilo
METTERE/workflows/{workflow_id}/programming/{workflow_programming_id}Aggiorna il profilo di programmazione
METTERE/workflows/{workflow_id}/programmazione/{workflow_programming_id}/archiveArchivia un flusso di lavoro di programmazione
METTERE/workflows/{workflow_id}/programming/{workflow_programming_id}/resumeRiepilogo di un flusso di lavoro di programmazione
METTERE/flussi di lavoro/{id_flusso_di_lavoro}/programmazione/{id_programmazione_flusso_di_lavoro}/passaggio/{id_passaggio}/riassuntoRiepilogo di una fase di programmazione del flusso di lavoro
METTERE/workflows/{workflow_id}/programmazione/{workflow_programming_id}/passaggio/{step_id}/stopInterrompi una fase di programmazione del flusso di lavoro
METTERE/workflows/{workflow_id}/programmazione/{workflow_programming_id}/stopInterrompi la programmazione del flusso di lavoro
METTERE/workflows/{workflow_id}/programming/{workflow_programming_id}/unarchiveDecomprimere un flusso di lavoro di programmazione
ELIMINARE/workflows/{workflow_id}Elimina un flusso di lavoro
ELIMINARE/workflows/exclude/programming/{exclusion_id}Rimuovere l'esclusione di un contatto da una programmazione

Lavoro Lavoro

Monitoraggio e arresto delle attività asincrone, eliminazione dei risultati non riusciti. 3 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/jobs/prm/{target_id}Elenco delle offerte di lavoro PRM
ELIMINARE/jobs/{job_uniqid}Interrompere un lavoro
ELIMINARE/jobs/failed/{job_uniqid}Elimina il risultato dell'operazione non riuscita

Pool di integrazione

Raggruppamento degli account mittenti (integrazioni) in pool. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/piscineRecupera elenco
OTTENERE/pools/{pool_id}Trova il profilo
INVIARE/piscineCrea una piscina
INVIARE/pools/{pool_id}/{integration_id}Aggiungi un'integrazione nel pool
METTERE/pools/{pool_id}Aggiorna il profilo
ELIMINARE/pools/{pool_id}Eliminare un pool
ELIMINARE/pools/{pool_id}/{integration_id}Rimuovere un'integrazione nel pool

Accorciatore di URL

Creazione singola o in blocco di URL brevi da utilizzare nei messaggi. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/abbreviatore-URLRecupera elenco
OTTENERE/urls-shortener/{shortened_url_id}Trova il profilo
OTTENERE/urls-shortener/{url_code}Trova l'URL tramite il codice URL
INVIARE/abbreviatore-URLCrea un URL abbreviato
INVIARE/abbreviatore-URL/in massaCrea URL abbreviati in blocco
METTERE/urls-shortener/{shortened_url_id}Aggiorna il profilo
ELIMINARE/urls-shortener/{shortened_url_id}Elimina un URL abbreviato

Moduli Forms

Creazione, copia e gestione di moduli. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/moduliRecupera elenco
OTTENERE/moduli/{form_id}Trova il profilo
INVIARE/moduliCrea un modulo
INVIARE/forms/{form_id}/copyCopia un modulo
METTERE/moduli/{form_id}Aggiorna un profilo modulo
ELIMINARE/moduli/{form_id}Elimina un modulo

Canali di invio e recapito

Collegamento degli account di invio e degli strumenti di deliverability (riscaldamento, protezione antispam, domini). 33 endpoint.

e-mail – E-mail

Gmail, Outlook, SMTP e account per l'invio massivo di email: rilevamento automatico delle impostazioni del server, test di validità SMTP, impostazioni di pre-riscaldamento e statistiche, protezione dallo spam ricevuto. 19 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/integrazioni/emailRecupera elenco
OTTENERE/integrazioni/email/{email_account_id}Trova il profilo
OTTENERE/integrazioni/email/scopri/{email}Scopri le impostazioni del server di posta elettronica tramite Autodiscover
OTTENERE/integrazioni/email/protezioniElenca le protezioni antispam che hai ricevuto via email
OTTENERE/integrazioni/email/smtp/{email_account_id}/riscaldamentoRecupera le impostazioni di riscaldamento per un account di posta elettronica SMTP
OTTENERE/integrazioni/email/smtp/{email_account_id}/riscaldamento/statisticheRecupera le statistiche di riscaldamento per un account di posta elettronica SMTP.
INVIARE/integrazioni/email/gmailAggiungi un account email Gmail
INVIARE/integrazioni/email/invio di email di massaAggiungi un account email per l'invio di email di massa
INVIARE/integrazioni/email/OutlookAggiungi un account di posta elettronica Outlook
INVIARE/integrazioni/email/smtpAggiungi un account di posta elettronica SMTP
METTERE/integrazioni/email/gmail/{email_account_id}Aggiornare un account di posta elettronica Gmail
METTERE/integrazioni/email/invio massivo di email/{email_account_id}Aggiorna l'account email per l'invio di email di massa
METTERE/integrazioni/email/invio massivo di email/{email_account_id}/forza/validaForza la convalida dell'indirizzo email per l'invio di email di massa
METTERE/integrazioni/email/outlook/{email_account_id}Aggiornare un account di posta elettronica Outlook
METTERE/integrazioni/email/protezione/{protection_id}Imposta una protezione come gestito
METTERE/integrazioni/email/smtp/{email_account_id}Aggiornare un account di posta elettronica SMTP
METTERE/integrazioni/email/smtp/{email_account_id}/riscaldamentoAggiorna le impostazioni di preriscaldamento per un account di posta elettronica SMTP
METTERE/integrazioni/email/smtp/validità/testTest di validità degli account di posta elettronica SMTP
ELIMINARE/integrazioni/email/{email_account_id}Elimina un account email

Integrazioni LinkedIn – LinkedIn

Collegamento degli account LinkedIn, risoluzione dei checkpoint di autenticazione, aggiornamento ed eliminazione. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/integrazioni/linkedinRecupera elenco
OTTENERE/integrazioni/linkedin/{linkedin_account_id}Trova il profilo
INVIARE/integrazioni/linkedinAggiungi un account LinkedIn
INVIARE/integrazioni/linkedin/{linkedin_account_id}/checkpointRisolvi un checkpoint di autenticazione utilizzando il codice che hai ricevuto. Se il checkpoint avviene tramite l'app, puoi inserire qualsiasi codice desideri una volta convalidato
METTERE/integrazioni/linkedin/{linkedin_account_id}Aggiornare un account LinkedIn
ELIMINARE/integrazioni/linkedin/{linkedin_account_id}Eliminare un account LinkedIn

OVH (domini ed email) OVH

Verifica della disponibilità e del prezzo del dominio, ordinazione del dominio e dell'account Email Pro, sincronizzazione delle risorse OVH. 8 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/ovhRecupera elenco
OTTENERE/ovh/account/{external_api_key_id}/validate-ordering-prerequisitesVerifica la disponibilità dell'account OVH per effettuare l'ordine
OTTENERE/ovh/dominio/disponibilità/{dominio}/{ID_chiave_API_esterna}Verifica la disponibilità del dominio e il prezzo
OTTENERE/ovh/sync-assets/{external_api_key_id}/resultsRecupera i risultati del processo di sincronizzazione delle risorse
INVIARE/ovh/checkoutOrdina un dominio e/o gli account email professionali associati
INVIARE/ovh/sync-assetsSincronizza i domini/indirizzi email di OVH
ELIMINARE/ovh/dominio/{domain_id}Eliminare un dominio OVH
ELIMINARE/ovh/email/{email_id}Eliminare un account email OVH

PRM: CRM per la ricerca di potenziali clienti

Il sistema PRM (Prospect Relationship Management) centralizza i contatti attivi e la loro cronologia. 57 endpoint.

PRM PRM

Ricerca di un contatto tramite email o URL di LinkedIn, importazione ed esportazione, note con allegati, chiamate, invio di inviti e messaggi su LinkedIn, stati personalizzati, tag, condivisione tra utenti, nurturing, esclusione da un flusso di lavoro, arricchimento tramite API esterne, qualificazione positiva/negativa delle risposte e suggerimenti di risposta generati dall'IA. 57 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/prm/contattoTrova il profilo di un contatto tramite email o URL di LinkedIn
OTTENERE/prm/contact/{contact_id}Trova il profilo di un contatto
OTTENERE/prm/contact/{contact_id}/note/{note_id}/attachmentsOttieni allegati di note
OTTENERE/prm/contact/user/{user_id}Trova il profilo di contatto di un PRM tramite email o URL di LinkedIn
OTTENERE/prm/contattiRecupera i contatti del tuo PRM
OTTENERE/prm/contatti/condivisiRecupera i contatti del tuo PRM che hai condiviso
OTTENERE/prm/contatti/utente/{user_id}Recupera i contatti di un PRM
OTTENERE/prm/contatti/utentiRecupera i contatti di più PRM
OTTENERE/prm/listElenco visibile a PRM
OTTENERE/prm/notificazioni/voce-di-colonnaRecupera l'elenco di controllo delle notifiche relative alle voci di colonna PRM
OTTENERE/prm/nutrimento/{id_nutrimento}Ottieni un PRM nutriente
OTTENERE/prm/nutrizioniOttieni supporto PRM
OTTENERE/prm/condivisioniRecupera la tua condivisione PRM
OTTENERE/prm/statusRecupera lo stato del tuo PRM
OTTENERE/prm/status/customRecupera i tuoi stati personalizzati PRM
INVIARE/prm/contact/{contact_id}/callCrea una chiamata PRM da un contatto
INVIARE/prm/contact/{contact_id}/enrich/phone/mobileArricchisci un numero di telefono di contatto
INVIARE/prm/contact/{contact_id}/exclude/{workflow_id}Escludi un contatto PRM da un flusso di lavoro
INVIARE/prm/contatto/{contact_id}/escludi/programmazione/{programming_id}Escludi un contatto PRM da una programmazione
INVIARE/prm/contatto/{contact_id}/linkedin/invitoInvia un invito su LinkedIn a un contatto
INVIARE/prm/contatto/{contact_id}/linkedin/messaggioInvia un messaggio LinkedIn a un contatto
INVIARE/prm/contact/{contact_id}/noteCrea una nota PRM da un contatto
INVIARE/prm/contact/{contact_id}/note/{note_id}/attachmentCarica allegati alle note
INVIARE/prm/contatto/{contact_id}/programmazione/{programming_id}/passo/{step_id}Avanza manualmente un contatto a un evento dopo una fase di chiamata
INVIARE/prm/contact/{contact_id}/reply/{history_type_reply}/{reply_id}/suggest-replyGenera una risposta suggerita utilizzando l'intelligenza artificiale
INVIARE/prm/contattiImporta i contatti nel tuo PRM
INVIARE/prm/contacts/contact-list/{contact_list_id}/addAggiungi i contatti da un PRM a un elenco contatti
INVIARE/prm/contacts/enrich/external/{enrich_external_api}/{external_api_key_id}Arricchisci il PRM utilizzando un'API esterna
INVIARE/prm/contacts/export/{file_type}Esporta i contatti del tuo PRM
INVIARE/prm/contatti/importazioneContatti per l'importazione
INVIARE/prm/contatti/utente/{user_id}Importa i contatti in un PRM
INVIARE/prm/contacts/user/{user_id}/copy/blacklist/{blacklist_id}Copia i contatti PRM nella lista nera
INVIARE/prm/contacts/user/{user_id}/enrich/external/{enrich_external_api}/{external_api_key_id}Arricchisci il PRM utilizzando un'API esterna
INVIARE/prm/contacts/user/{user_id}/export/{file_type}Contatti di esportazione di un PRM
INVIARE/prm/contatti/utente/{user_id}/tagAggiungi tag ai contatti di un PRM
INVIARE/prm/nutrimentoCreare un PRM di supporto
INVIARE/prm/condivisioniCreare condivisione
INVIARE/prm/status/customCrea uno stato personalizzato PRM
METTERE/prm/contact/{contact_id}Aggiorna un contatto PRM
METTERE/prm/contact/{contact_id}/note/{note_id}Aggiorna una nota PRM da un contatto
METTERE/prm/contact/{contact_id}/reply/{history_type_reply}/{reply_id}Contrassegna la risposta di un contatto come positiva/negativa oppure rimuovi il contrassegno
METTERE/prm/contatti/nuova_rispostaAggiorna i contatti PRM nuova risposta
METTERE/prm/contatti/statoAggiornare lo stato dei contatti PRM
METTERE/prm/notificazioni/voce-di-colonnaSostituisci la watchlist di notifica della voce di colonna PRM
METTERE/prm/nutrimento/{id_nutrimento}Aggiornare un PRM nurturing
METTERE/prm/sharings/{sharing_id}Aggiornamento della condivisione
METTERE/prm/status/{status}Aggiornare lo stato di un PRM
METTERE/prm/status/custom/{status_id}Aggiornare lo stato personalizzato di un PRM
ELIMINARE/prm/contact/{contact_id}/call/{call_id}Eliminare una chiamata PRM da un contatto
ELIMINARE/prm/contact/{contact_id}/note/{note_id}Elimina una nota PRM da un contatto
ELIMINARE/prm/contatto/{contact_id}/nota/{note_id}/allegato/{attachment_id}Elimina l'allegato della nota
ELIMINARE/prm/contattiElimina i contatti dal tuo PRM
ELIMINARE/prm/contatti/utente/{user_id}Eliminare i contatti da un PRM
ELIMINARE/prm/contatti/utente/{user_id}/tagRimuovere i tag dai contatti di un PRM
ELIMINARE/prm/nutrimento/{id_nutrimento}Elimina un PRM nurturing
ELIMINARE/prm/sharings/{sharing_id}Elimina la condivisione
ELIMINARE/prm/status/custom/{status_id}Eliminare uno stato personalizzato PRM

Statistiche e reportistica

Misurazione delle performance della campagna, dal livello generale fino al singolo intervistato. 26 endpoint.

Statistica Statistics

Statistiche complete, per integrazione e per programma, dettagliate giornalmente ed esportabili. Analisi dei rispondenti per canale, paese, regione, settore, dimensione aziendale, tag, proprietario e stato PRM. 21 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/statistiche/globaliRecupera le statistiche globali sulla programmazione
OTTENERE/statistiche/integrazioniRecupera le statistiche delle integrazioni
OTTENERE/statistiche/messaggiRecupera l'elenco dei possibili messaggi statistici
OTTENERE/statistiche/programmazioniRecupera le statistiche di programmazione
OTTENERE/statistiche/programmazioni/{programmazione_id}Recupera le statistiche di un programma
OTTENERE/statistiche/programmazioni/{programmation_id}/download/{file_type}Scarica le statistiche di un programma
OTTENERE/statistiche/programmazioni/download/{tipo_file}Scarica le statistiche di programmazione
INVIARE/statistiche/dataRecupera le statistiche di programmazione per data
INVIARE/statistiche/data/contattiScarica i contatti di programmazione per data
INVIARE/statistiche/data/dettagliateRecupera le statistiche di programmazione in base a vari parametri, giorno per giorno
INVIARE/statistiche/globali/dettagliateRecupera statistiche globali di programmazione in base a vari parametri
INVIARE/statistiche/rispondenti/per-canale-e-statoRispondenti per canale e stato PRM
INVIARE/statistiche/rispondenti/per-dimensione-aziendaIntervistati per dimensione dell'azienda
INVIARE/statistiche/rispondenti/per-dimensione-e-stato-dell'aziendaRispondenti per dimensione aziendale e stato PRM
INVIARE/statistiche/rispondenti/per-paeseIntervistati per paese
INVIARE/statistiche/rispondenti/per-proprietario-prmRisponditori per contatto PRM proprietario
INVIARE/statistiche/rispondenti/per-programmazione-e-listaRisponditori per programmazione e lista contatti
INVIARE/statistiche/rispondenti/per-regioneRispondenti per paese e regione
INVIARE/statistiche/rispondenti/per settoreRispondenti per settore di attività (primi 10)
INVIARE/statistiche/rispondenti/per-settore-e-statoRispondenti per settore di attività (primi 10) e stato PRM
INVIARE/statistiche/rispondenti/per-tagRisponditori tramite tag di contatto PRM

Rapporti Reporting

Creazione e gestione di report personalizzati. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/reporting/report/{report_id}Recupera un rapporto
OTTENERE/segnalazione/segnalazioniRecupera l'elenco dei report
INVIARE/segnalazione/segnalazioneCrea un report
METTERE/reporting/report/{report_id}Aggiornamento del rapporto
ELIMINARE/reporting/report/{report_id}Elimina un report

Automazione e integrazioni con terze parti

Collegamento di Magileads al resto dello stack (CRM, strumenti no-code, back-office). 22 endpoint.

Webhook Webhooks

Creazione, test e gestione di webhook per la ricezione di eventi da Magileads. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/webhooksRecupera elenco
OTTENERE/webhooks/{webhook_id}Trova il profilo
INVIARE/webhooksCrea un webhook
INVIARE/webhooks/{webhook_id}/testTesta un webhook
METTERE/webhooks/{webhook_id}Aggiorna un webhook
ELIMINARE/webhooks/{webhook_id}Elimina un webhook

Zapier Zapier

Zapier Hooks: creazione, attivazione, disattivazione, test e invio. 9 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/zapierRecupera elenco
OTTENERE/zapier/{zapier_hook_id}Trova il profilo
INVIARE/zapierCrea un hook Zapier
INVIARE/zapier/{zapier_hook_id}/inviaInvia un hook Zapier
INVIARE/zapier/{zapier_hook_id}/testProva un hook di Zapier
METTERE/zapier/{zapier_hook_id}Aggiorna il profilo
METTERE/zapier/{zapier_hook_id}/attivaAttiva un hook di Zapier
METTERE/zapier/{zapier_hook_id}/disattivaDisattiva un hook di Zapier
ELIMINARE/zapier/{zapier_hook_id}Elimina un hook di Zapier

Crons Crons

Attività programmate: creazione, esecuzione manuale e test con dati fittizi. 7 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/cronsRecupera elenco
OTTENERE/crons/{cron_id}Trova il profilo
INVIARE/cronsCrea un cron
INVIARE/crons/{cron_id}/eseguiEseguire manualmente un cron
INVIARE/crons/{cron_id}/testTesta un processo cron con dati fittizi
METTERE/crons/{cron_id}Aggiornare un profilo cron
ELIMINARE/crons/{cron_id}Elimina un cron

Etichetta bianca (rivenditori)

Endpoint destinati ai rivenditori che utilizzano Magileads con il proprio marchio. 33 endpoint.

Rivenditori Resellers

Profilo rivenditore tramite ID o dominio SaaS, utenti e tag, opzioni, messaggi transazionali, video tutorial, aggiornamento CNAME e DNS, estensione Chrome white-label e chiave OpenRouter. 22 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/rivenditori/{dominio_rivenditore_saas}Trova il profilo per dominio SaaS
OTTENERE/rivenditori/{dominio_rivenditore_saas}/utentiRecupera l'elenco degli utenti per dominio SaaS
OTTENERE/rivenditori/{reseller_id}Trova il profilo tramite ID
OTTENERE/resellers/{reseller_id}/download/extension/chromeScarica l'estensione per Chrome
OTTENERE/resellers/{reseller_id}/openrouter-api-keyRecupera la chiave API del rivenditore OpenRouter
OTTENERE/rivenditori/{reseller_id}/opzioniRichiedi informazioni a un rivenditore
OTTENERE/rivenditori/{reseller_id}/tutorial/videoOttieni video tutorial per rivenditori
OTTENERE/rivenditori/{reseller_id}/utentiRecupera l'elenco degli utenti tramite ID
OTTENERE/rivenditori/cnamesRecupera l'elenco dei nostri CNAME
OTTENERE/rivenditori/messaggiRicevi messaggi di base transazionali
OTTENERE/rivenditori/messaggi/{reseller_id}Ricevi i messaggi transazionali di un rivenditore, inclusi i messaggi di base
INVIARE/rivenditoriCrea un rivenditore. Gli utenti del tuo rivenditore dovranno utilizzare il tuo dominio_saas/dominio_saas2/dominio_saas3/dominio_saas4
INVIARE/rivenditori/{reseller_id}Aggiorna il profilo
INVIARE/rivenditori/{reseller_id}/richieste-di-aggiornamento-dnsRichieste di aggiornamento DNS per domini di rivenditori
INVIARE/rivenditori/{reseller_id}/messaggiCrea o aggiorna un messaggio transazionale per un rivenditore
INVIARE/rivenditori/{reseller_id}/opzioniCrea o aggiorna più opzioni per un rivenditore
INVIARE/rivenditori/{reseller_id}/tutorial/videoCreare, aggiornare o eliminare più video tutorial per un rivenditore
METTERE/rivenditori/{reseller_id}/messaggi/colonne-tabella/prm-digestConfigura le colonne della tabella per l'e-mail di riepilogo giornaliero di PRM
METTERE/rivenditori/{reseller_id}/ruolo/{user_id}Aggiornare il ruolo di un utente
METTERE/rivenditori/{reseller_id}/utenti/{user_id}/tagAggiorna i tag utente del rivenditore
ELIMINARE/rivenditori/{reseller_id}Elimina un rivenditore
ELIMINARE/rivenditori/{reseller_id}/utenti/{user_id}Elimina utente rivenditore

Rivenditori: Mailgun Resellers – Mailgun

Configurazione di Mailgun gestita dal rivenditore: domini (creazione, importazione, condivisione, verifica DNS) e statistiche per il mese corrente. 11 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/rivenditori/{reseller_id}/mailgunRecupera la configurazione del rivenditore Mailgun
OTTENERE/rivenditori/{reseller_id}/mailgun/dominiElenco dei domini Mailgun visibili gestiti dal rivenditore
OTTENERE/rivenditori/{reseller_id}/mailgun/domini/{domain_id}Recuperare un dominio Mailgun gestito da un rivenditore
OTTENERE/rivenditori/{reseller_id}/mailgun/statisticheRecupera le statistiche Mailgun gestite per il mese corrente
INVIARE/rivenditori/{reseller_id}/mailgunConfigurare Mailgun gestito dal rivenditore
INVIARE/rivenditori/{reseller_id}/mailgun/importazione-dominioImporta un dominio Mailgun esistente
INVIARE/rivenditori/{reseller_id}/mailgun/dominiCrea un dominio Mailgun gestito da rivenditore
INVIARE/rivenditori/{reseller_id}/mailgun/domini/{domain_id}Aggiornare la proprietà e la condivisione del dominio Mailgun gestito
INVIARE/rivenditori/{reseller_id}/mailgun/domini/{domain_id}/richieste-di-aggiornamento-dnsAggiorna la verifica DNS di Mailgun gestita
ELIMINARE/rivenditori/{reseller_id}/mailgunElimina la configurazione del rivenditore Mailgun
ELIMINARE/rivenditori/{reseller_id}/mailgun/domini/{domain_id}Eliminare o scollegare un dominio Mailgun gestito

File e cartelle

Archiviazione di file e organizzazione di cartelle. 11 endpoint.

File Files

Caricamento, ricerca, aggiornamento ed eliminazione di file. 6 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/filesRecupera elenco
OTTENERE/files/{file_id}Trova il profilo
INVIARE/filesCarica un file
INVIARE/files/{file_id}Aggiorna il profilo
INVIARE/files/searchCerca file
ELIMINARE/files/{file_id}Elimina un file

Cartelle Folders

Organizzazione delle risorse in cartelle. 5 endpoint.

MetodoPunto finaleDescrizione
OTTENERE/cartelleRecupera elenco
OTTENERE/cartelle/{folder_id}Trova il profilo
INVIARE/cartelleCrea una cartella
METTERE/cartelle/{folder_id}Aggiorna il profilo
ELIMINARE/cartelle/{folder_id}Elimina una cartella

Domande frequenti sull'API Magileads V2: API Magileads V2

Che cos'è l'API di Magileads?

L'API di Magileads è l'interfaccia REST della piattaforma di prospecting multicanale B2B di Magileads. Descritta in formato OpenAPI 3.0 (versione 2.0.0), espone 505 endpoint che coprono il targeting su LinkedIn e Google Maps, l'arricchimento dei contatti, le campagne email, LinkedIn e SMS, il PRM e le statistiche.

Qual è l'URL di base dell'API di Magileads?

Tutte le richieste vengono inviate a https://app.api-magileads.net. Le risposte sono in formato JSON e tutte le date sono espresse in GMT.

Come faccio ad autenticarmi sull'API di Magileads?

Il metodo più semplice consiste nel passare la chiave API nell'intestazione HTTP x-api-key. L'API offre anche un server OAuth 2.0 (flusso del codice di autorizzazione, aggiornamento e revoca del token) per applicazioni di terze parti.

È possibile estrarre lead da LinkedIn e Sales Navigator tramite API?

Sì. Il gruppo Targeting – LinkedIn ha 27 endpoint di estrazione: ricerche su LinkedIn e Sales Navigator (persone e aziende), connessioni, membri del gruppo, partecipanti agli eventi, visitatori del profilo, persone che mettono "mi piace", commentatori e persone che condividono i post.

L'API di Magileads integra l'intelligenza artificiale?

Sì. Gli endpoint generano modelli di email (testo e HTML), inviti e messaggi LinkedIn, brief per gli agenti AI, flussi di lavoro completi per ciascun agente AI e suggerimenti di risposta ai potenziali clienti nel PRM.

Come collegare Magileads a un CRM o a uno strumento senza codice?

Questo può essere fatto tramite webhook, hook di Zapier o interrogando direttamente gli endpoint PRM e Elenchi contatti. I cron job consentono di pianificare attività ricorrenti.

L'API Magileads V2 è disponibile come soluzione white-label?

Sì. I gruppi Rivenditori e Rivenditori – Mailgun consentono di gestire un'istanza white-label: dominio SaaS, CNAME, messaggi transazionali, opzioni, utenti e domini di invio Mailgun.

Hai bisogno di aiuto con l'integrazione? Contatta l'assistenza tecnica di Magileads all'indirizzo co*****@*******ds.eu.

Quali servizi offre Magileads?

Magileads offre soluzioni di prospecting omnicanale progettate per soddisfare le esigenze specifiche delle aziende. Il nostro team si avvale di tecnologie all'avanguardia e di un supporto strategico per generare lead di vendita qualificati.

In che modo Magileads aiuta nell'acquisizione di clienti?

Semplifichiamo il ciclo di vendita automatizzando la generazione di lead. La nostra piattaforma ti permette di individuare con precisione i tuoi potenziali clienti e di avviare una conversazione al momento giusto con il messaggio giusto.

Offrite strumenti di automazione del marketing?

Sì, la nostra piattaforma integra strumenti di Marketing Automation che ti consentono di automatizzare le conversazioni con i tuoi contatti tramite email, LinkedIn e telefonate, mantenendo al contempo un approccio personalizzato e umano.

Ricerca