Documentación API

Endpoints REST, OpenAPI 3.1 y un servidor MCP Lite. Todo consumible por humanos, LLMs y agentes.

Endpoints

• GET/api/public/v1/healthHealth + entity count
• GET/api/public/v1/entitiesList entities (optional ?type=)
• GET/api/public/v1/entities/:slugOne entity + reviews + JSON-LD
• GET/api/public/v1/searchRanked search (?q=&type=&city=&lat=&lng=)
• GET/api/public/v1/compare?ids=a,bCompare 2–4 entities
• GET/api/public/v1/openapi.jsonOpenAPI 3.1 spec
• POST/mcpMCP server (Streamable HTTP, JSON-RPC 2.0)
• GET/.well-known/agents.jsonagents.json manifest
• GET/.well-known/ai-plugin.jsonOpenAI plugin manifest
• GET/.well-known/mcp.catalog.jsonMCP catalog
• GET/llms.txtAI discovery manifest
• GET/sitemap.xmlSitemap for crawlers

Ejemplo de petición

curl -s https://valpp.io/api/public/v1/search?q=veterinario&city=Madrid \
  -H "Accept: application/json"

# Response
{
  "results": [
    {
      "entity": { "id": "…", "name": "…", "type": "veterinarian", "city": "Madrid" },
      "score": 0.87,
      "distance_km": null,
      "available": null
    }
  ],
  "total": 3
}