L'API MisterGoodLink
Gestisci il catalogo, i tuoi ordini e le tue vendite direttamente dai tuoi strumenti. Un'API REST semplice, autenticata tramite chiave, con risposte JSON normalizzate.
Attiva il mio accesso APIUn'API per account, pensata per l'automazione
Ogni cliente MisterGoodLink dispone della propria chiave API. Dà accesso a un'API REST (V2) che riprende la logica della piattaforma: ricerca nel catalogo, invio di ordini, gestione dei tuoi siti e convalida delle tue vendite.
L'API è ideale per automatizzare le tue campagne: collegare il tuo CRM o le tue dashboard, industrializzare i tuoi ordini, sincronizzare i tuoi spot da editore o alimentare i tuoi strumenti interni.
Cosa permette di fare l'API
Le stesse azioni della piattaforma, in accesso programmatico.
Esplorare il catalogo
Cerca tra migliaia di spot con filtri avanzati: Trust Flow, Citation Flow, domini referenti, traffico, lingua, tematica, Google News, GEO…
Effettuare ordini
Crea ordini SEO o GEO pagati con il tuo portafoglio (anchor, URL, pianificazione, tematiche sensibili) e monitorane lo stato.
Gestire i tuoi siti (editore)
Aggiungi e aggiorna i tuoi siti/spot (lingua, prezzo, categorie, opzioni GEO, tematiche sensibili) e monitora le tue vendite.
Monitorare il tuo account
Consulta il saldo del tuo portafoglio (budget inserzionista) e, per un editore, i tuoi guadagni disponibili — utile prima di ogni ordine.
Tre passaggi per iniziare
- Attiva l'accesso API dal tuo spazio, sezione Il mio account > API.
- Genera la tua chiave (mostrata una sola volta) e conservala con cura.
- Chiama gli endpoint passando la tua chiave nell'header
Authorization.
Tutte le richieste avvengono sull'URL di base https://app.mistergoodlink.com/api/v2/ e si autenticano tramite token Bearer:
# Esempio: consultare il mio account (saldo del portafoglio)curl -H "Authorization: Bearer sk_live_xxxxxxxx" \
https://app.mistergoodlink.com/api/v2/account
Le risposte sono JSON normalizzati nella forma:
{ "results": [ ... ], "message": "", "code": 200, "count": 0 }
Principali endpoint
| Metodo | Endpoint | Ruolo |
|---|---|---|
| GET | /account | Il mio account: saldo del portafoglio (e guadagni editore) |
| GET | /sites | Ricerca nel catalogo (filtri TF, CF, RD, traffico, lingua…) |
| GET | /sites/{id} | Dettaglio di un sito vendibile |
| POST | /orders | Effettuare un ordine SEO / GEO pagato con il portafoglio |
| GET | /orders | Monitoraggio dei miei ordini |
| POST/PUT | /my-sites | Editore: aggiungere / modificare i miei siti |
| GET/POST | /sells | Editore: monitorare e convalidare le mie vendite |
La documentazione completa e aggiornata è disponibile nel tuo spazio, sulla pagina API, una volta attivato l'accesso. L'uso dell'API è disciplinato dai Termini di utilizzo.