API REST di Report Seo

Automatizza le tue analisi SEO e integra Report Seo nei tuoi processi o software personalizzati.
Disponibile solo per utenti Pro e Agency.

🔑 Autenticazione

Per autenticare le richieste, devi includere la tua API Key nell'header HTTP:
X-API-KEY: la_tua_api_key

L'API key è disponibile nella tua dashboard.
Puoi rigenerarla in ogni momento.
Vai alla Dashboard

📈 Endpoint principali

Tutte le chiamate usano il formato JSON.
L'URL base è:
https://reportseo.it/api/

Endpoint	Metodo	Descrizione
/api/analyze	POST	Avvia un'analisi SEO su un sito (1 URL per richiesta)
/api/reports	GET	Lista dei tuoi report generati
/api/report/<hash>	GET	Dettagli di un report specifico (usando l'hash)

📤 Analisi SEO - /api/analyze

Metodo	POST
Endpoint	/api/analyze
Headers	X-API-KEY: la_tua_api_key Content-Type: application/json
Body JSON	{ "url": "https://esempio.com" }

Risposta di esempio:

{
    "success": true,
    "report_hash": "d48d34feba0be21e",
    "message": "Analisi avviata con successo",
    "voto": 87,
    "pdf_url": "https://reportseo.it/reports/tuonome/d48d34feba0be21e.pdf"
}

📋 Elenco report - /api/reports

Metodo	GET
Endpoint	/api/reports
Headers	X-API-KEY: la_tua_api_key

Risposta:

{
    "success": true,
    "reports": [
        {
            "hash": "d48d34feba0be21e",
            "url": "https://esempio.com",
            "data": "2024-05-18 15:11:42",
            "voto": 87,
            "pdf_url": "https://reportseo.it/reports/tuonome/d48d34feba0be21e.pdf"
        },
        ...
    ]
}

📄 Dettaglio singolo report - /api/report/<hash>

Metodo	GET
Endpoint	/api/report/<hash>
Headers	X-API-KEY: la_tua_api_key

Risposta:

{
    "success": true,
    "report": {
        "hash": "d48d34feba0be21e",
        "url": "https://esempio.com",
        "data": "2024-05-18 15:11:42",
        "voto": 87,
        "summary": {...}
    }
}

❓ Supporto

Per supporto tecnico, scrivi a
mail@reportseo.it