Public API

Connect Metavasi's GEO audit to your AI agents.

The `/api/v1/audit` endpoint returns the same audit as the web interface in JSON, with lightweight API key authentication.

Getting started

How to get an API key

Email hello@metavasi.io with your domain, use case, and desired plan. An API key in the `mvs_...` format will be provisioned in the Neon database.

Free

0€

API

For testing the integration with a light quota.

10 calls per month per API key

Pro

9€/month

API

For continuously connecting third-party AI agents.

Unlimited calls

Endpoint

`POST` or `GET` `/api/v1/audit`

Required fields: `url` and `api_key`.

Authentication: JSON body, query string, `X-API-Key`, or `Authorization: Bearer`.

CORS: `Access-Control-Allow-Origin: *` to allow calls from third-party AI agents.

Errors: explicit JSON if the key is invalid, missing, or if the monthly quota is exceeded.

Priority enum values currently returned by the API are `haute`, `moyenne`, and `basse`.

POST example

curl -X POST https://metavasi.io/api/v1/audit \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "api_key": "mvs_xxx"
  }'

GET example

curl "https://metavasi.io/api/v1/audit?url=https://example.com&api_key=mvs_xxx"

JSON response

{
  "url": "https://example.com/",
  "finalUrl": "https://example.com/",
  "score": 74,
  "categories": {
    "clarity": {
      "label": "Content clarity",
      "score": 18,
      "maxScore": 20,
      "findings": ["The main content is dense and easy to identify."]
    }
  },
  "recommendations": [
    {
      "text": "Add more structured data.",
      "priority": "haute"
    }
  ],
  "summary": "The site already shows strong signals for AI answer engines."
}

Response fields

score

Overall GEO score out of 100 calculated from clarity, metadata, authority, and AI accessibility.