Primi passi con l'API

L'API di Meirra offre accesso programmatico ai nostri servizi di verifica email, arricchimento contatti, lead generation e analisi SEO. Grazie a un'interfaccia REST semplice e a una tariffazione pay-as-you-go puoi integrare strumenti di dati potenti direttamente nelle tue applicazioni. Questa guida ti accompagnerà passo dopo passo nella creazione della tua prima chiave API e nella tua prima richiesta.

Per usare l'API ti serve una chiave. Accedi al tuo account Meirra e apri il Pannello sviluppatori. Clicca su 'Crea chiave API' e dagli un nome descrittivo (ad esempio 'App di produzione' o 'Test'). La chiave verrà mostrata una sola volta: copiala e conservala in un luogo sicuro. Le chiavi API iniziano con 'mk_live_' per la produzione o 'mk_test_' per gli ambienti di test.

Verifichiamo un indirizzo email. Includi la tua chiave API nell'intestazione x-api-key: ```bash curl -X POST https://api.meirra.com/v1/email/verify \ -H "x-api-key: mk_live_la_tua_chiave_qui" \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}' ``` Riceverai una risposta JSON con il risultato della verifica: validità, recapitabilità ed eventuali indicatori di rischio.

Tutte le risposte dell'API seguono un formato coerente: ```json { "success": true, "data": { ... }, "usage": { "cost": 0.005, "balanceRemaining": 19.995 } } ``` Il campo `success` indica se la richiesta è andata a buon fine. `data` contiene il risultato. `usage` mostra il costo della richiesta e il saldo residuo.

Ora che hai fatto la tua prima richiesta, esplora altri endpoint: • **Verifica email** – verifica singole email o elabora lotti fino a 100 alla volta • **Arricchimento contatti** – trova email di contatti partendo da nome e azienda • **Arricchimento aziende** – ottieni tutti i contatti per un dominio aziendale • **Ricerca lead** – cerca aziende su Google Maps o nei registri ufficiali • **Analisi SEO** – esegui test PageSpeed, traccia keyword e genera audit Ricorda di controllare il saldo regolarmente e di ricaricare al bisogno per evitare interruzioni del servizio.