Marketplace API

Overview

API para el marketplace de proyectos I+D+i. Incluye AutoMatch, sistema de búsqueda inteligente con IA que encuentra proyectos compatibles en lenguaje natural.

Base Path

/api/marketplace

AutoMatch - Búsqueda Inteligente

POST /api/automatch

Búsqueda en lenguaje natural con IA. El sistema analiza la consulta y retorna proyectos ordenados por Match Score (porcentaje de compatibilidad).

Request Body

{
  "query": "100.000 euros en IA y salud en Bizkaia"
}

Response 200

{
  "success": true,
  "data": {
    "query": "100.000 euros en IA y salud en Bizkaia",
    "results": [
      {
        "project": {
          "id": "proj_123",
          "title": "Sistema IA para diagnóstico médico",
          "amount": 150000,
          "sector": "Biotecnología / Salud",
          "region": "BIZKAIA",
          "type": "ID"
        },
        "matchScore": 95,
        "matchReasons": [
          "Sector coincide: Salud",
          "Tecnología coincide: IA",
          "Región coincide: Bizkaia",
          "Importe compatible: 150.000"
        ]
      },
      {
        "project": {
          "id": "proj_456",
          "title": "Plataforma telemedicina con IA",
          "amount": 120000,
          "sector": "Biotecnología / Salud",
          "region": "BIZKAIA",
          "type": "IT"
        },
        "matchScore": 88,
        "matchReasons": [
          "Sector coincide: Salud",
          "Tecnología coincide: IA",
          "Región coincide: Bizkaia"
        ]
      }
    ],
    "totalResults": 8
  }
}

Ejemplos de Queries

• "Proyectos de biotecnología en Bizkaia"
• "50.000 euros en software con alta deducción"
• "I+D en energía renovable Gipuzkoa"
• "Proyectos urgentes menos de 48 horas"
• "IA sector salud menos de 100k"

Match Score

Filtros del Marketplace

GET /api/marketplace/filters

Obtiene todos los filtros disponibles (regiones, sectores, tipos, rangos de importe).

Response 200

{
  "success": true,
  "data": {
    "regions": ["BIZKAIA", "GIPUZKOA", "ARABA", "NAVARRA"],
    "sectors": [
      "Tecnología / Software",
      "Biotecnología / Salud",
      "Energía / Sostenibilidad",
      "Manufactura / Industria 4.0",
      "Agroalimentario",
      "Otros"
    ],
    "types": ["ID", "IT", "INNOVACION"],
    "amountRanges": [
      { "label": "Menos de 50.000", "min": 0, "max": 50000 },
      { "label": "50.000 - 100.000", "min": 50000, "max": 100000 },
      { "label": "100.000 - 250.000", "min": 100000, "max": 250000 },
      { "label": "250.000 - 500.000", "min": 250000, "max": 500000 },
      { "label": "Más de 500.000", "min": 500000, "max": null }
    ],
    "status": ["ACTIVE", "FEATURED", "URGENT", "FUNDED"]
  }
}

GET /api/matching/compatible-projects

Obtiene proyectos compatibles con perfil de inversor (sin búsqueda IA).

Query Parameters

• type - Tipo de proyecto (ID, IT, INNOVACION)
• region - Región (BIZKAIA, GIPUZKOA, etc.)
• sector - Sector
• minAmount - Importe mínimo
• maxAmount - Importe máximo
• status - Estado (ACTIVE por defecto)
• page - Número de página
• limit - Resultados por página (max 50)

Request

GET /api/matching/compatible-projects?type=ID&region=BIZKAIA&minAmount=50000&maxAmount=200000

Favoritos

GET /api/favorites/user

Obtiene proyectos favoritos del usuario autenticado.

Response 200

{
  "success": true,
  "data": [
    {
      "id": "fav_123",
      "project": {
        "id": "proj_123",
        "title": "Sistema IA para diagnóstico médico",
        "amount": 150000,
        "fundedAmount": 75000,
        "region": "BIZKAIA"
      },
      "addedAt": "2025-01-02T10:00:00Z"
    }
  ]
}

POST /api/favorites/toggle

Añade o quita un proyecto de favoritos.

Request Body

{
  "projectId": "proj_123"
}

Response 200

{
  "success": true,
  "data": {
    "projectId": "proj_123",
    "isFavorite": true,
    "message": "Proyecto añadido a favoritos"
  }
}

Próximos Pasos

• Projects API - Ver detalles de proyectos
• Offers API - Hacer ofertas
• Marketplace Guide - Guía de uso del marketplace