Developer API

SEO.ro API, facut pentru integrari rapide.

Ruleaza audituri SEO din aplicatii, extensii, panouri de hosting, CI/CD sau tool-uri interne. Foloseste mode=fast pentru raspunsuri rapide si mode=full pentru audit complet.

Authentication

Trimite cheia in headerul X-SEO-RO-API-Key. Cheia se genereaza din profilul contului SEO.ro.

X-SEO-RO-API-Key: YOUR_API_KEY

Endpoint

POST https://www.seo.ro/api/seo-audit.php

Merge si prin GET pentru tool-uri simple, dar POST este recomandat.

curl -X POST https://www.seo.ro/api/seo-audit.php \
  -H "Accept: application/json" \
  -H "X-SEO-RO-API-Key: YOUR_API_KEY" \
  -d "url=https://example.com" \
  -d "keyword=seo" \
  -d "mode=fast"

Parametri

Nume	Valori	Descriere
`url` sau `domain`	URL	Pagina sau domeniul de analizat.
`keyword`	text	Keyword optional pentru intentie, densitate si AI checks.
`mode`	`fast`, `full`	`fast` sare peste verificari lente. `full` ruleaza tot.
`include_raw`	`0`, `1`	Include datele brute complete. Recomandat doar pentru debug.
`pretty`	`0`, `1`	Formateaza JSON-ul pentru citire umana.

Raspuns

{
  "status": "success",
  "meta": {
    "domain": "https://example.com",
    "keyword": "seo",
    "mode": "fast",
    "execution_time": 1.42
  },
  "score": {
    "total": 91,
    "breakdown": {}
  },
  "summary": {
    "passed_checks": 54,
    "failed_checks": 6,
    "critical_issues": []
  }
}

Erori

401 pentru cheie lipsa sau invalida, 429 pentru rate limit, 500 cand analiza nu poate fi finalizata.

Rate limits

Raspunsurile includ headere X-RateLimit-Limit-Hour, X-RateLimit-Remaining-Hour, X-RateLimit-Limit-Day si X-RateLimit-Remaining-Day.

Menu