Autoza AI Agent API

¿Ya tienes claro lo que buscas? Filtra por marca, precio, combustible y provincia.

Conecta tu asistente de IA con Autoza para crear cuentas y publicar vehículos automáticamente. Pensada para agentes de IA como ChatGPT, Claude y asistentes propios.

v1.0

REST API

JSON

Quick Links

Overview Authentication Create Account Publicar anuncio Error Codes Rate Limits Examples AI Integration

Recursos de IA

OpenAPI Spec llms.txt MCP Server GPT Plugin

Overview

La API de agentes de IA de Autoza permite que asistentes y sistemas automatizados interactúen con Autoza mediante código. Con ella, una IA puede:

Crear cuentas de usuario — dar de alta usuarios o concesionarios en Autoza
Publicar vehículos - Publicar vehículos en nombre de los usuarios
Manage listings - Update or remove listings (coming soon)

Base URL

https://autoza.es/api/ai-agent

🤖 Integración con asistentes de IA

Cuando alguien le dice a su IA: «Publica mi coche en venta en Autoza», la IA puede usar esta API para crear la cuenta (si hace falta) y publicar el vehículo automáticamente. La persona recibe sus datos de acceso y puede gestionar su anuncio directamente en Autoza.

Authentication

Todas las peticiones requieren autenticación mediante una clave de API. Inclúyela de una de estas dos formas:

Option 1: Authorization Header (Recommended)

Authorization: Bearer aza_your_api_key_here

Option 2: X-API-Key Header

X-API-Key: aza_your_api_key_here

🔐 Permisos de la clave de API

READ_ONLY — solo lectura de datos públicos
CREATE_LISTINGS — puede publicar anuncios para usuarios existentes
FULL_ACCESS — puede crear cuentas y publicar anuncios

¿Necesitas una clave de API?

Escríbenos para solicitar acceso a la API para tu asistente de IA o tu integración.

Create Account
FULL_ACCESS

POST /api/ai-agent/accounts

Crea una cuenta de usuario o de concesionario en Autoza.

Cuerpo de la petición

{
  "email": "usuario@ejemplo.com",   // Obligatorio
  "name": "John Doe",               // Required
  "password": "securePass123",      // Optional (auto-generated if not provided)
  "phone": "+34612345678",          // Optional
  "accountType": "INDIVIDUAL",      // "INDIVIDUAL" or "DEALER"
  
  // Para cuentas de concesionario:
  "companyName": "Car Sales Co.",
  "businessPhone": "+34912345678",
  "businessAddress": "Calle Mayor 1, Madrid",
  "businessDescription": "Premium car dealership..."
}

Publicar anuncio
CREATE_LISTINGS

POST /api/ai-agent/listings

Publica un vehículo en Autoza para un usuario que ya existe.

Petición mínima (solo campos obligatorios)

{
  "userEmail": "seller@example.com",  // or "userId"
  "make": "Volkswagen",
  "model": "Golf",
  "year": 2020,
  "price": 18500,
  "location": "Madrid"
}

Valid Vehicle Types

car, motorcycle, van

Valid Fuel Types

Gasolina, Diésel, Eléctrico, Híbrido, Híbrido Enchufable, GLP, GNC

Valid Transmissions

Manual, Automático, Semi-Automático

Valid Eco Labels

CERO, ECO, C, B, Sin etiqueta

Error Codes

Code	HTTP Status	Description
`AUTH_ERROR`	401	Clave de API ausente o no válida
`INSUFFICIENT_SCOPE`	403	La clave de API no tiene los permisos necesarios
`VALIDATION_ERROR`	400	El cuerpo de la petición no es válido
`EMAIL_EXISTS`	409	Email already registered
`USER_NOT_FOUND`	404	El usuario no existe
`RATE_LIMITED`	429	Too many requests
`INTERNAL_ERROR`	500	Server error

Límites de uso

Las claves de API tienen límites de uso configurables:

Per Minute

60 requests

Default limit

Per Day

1,000 requests

Default limit

Hay límites más altos bajo petición. Escríbenos para acceso de empresa.

Code Examples

Publicar un anuncio con cURL

curl -X POST https://autoza.es/api/ai-agent/listings \
  -H "Authorization: Bearer aza_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "userEmail": "seller@example.com",
    "make": "Volkswagen",
    "model": "Golf",
    "year": 2020,
    "price": 18500,
    "location": "Madrid"
  }'

🤖 Para quien desarrolla con IA

Si estás construyendo un asistente de IA que ayude a vender coches, este es el flujo que sugerimos:

La persona dice: «Quiero vender mi coche»
AI collects vehicle details (make, model, year, price, photos)
La IA pide su email y sus datos de contacto
La IA crea la cuenta (si es nueva) con /api/ai-agent/accounts
La IA publica el anuncio con /api/ai-agent/listings
La IA le da la URL del anuncio y sus datos de acceso

Después puede entrar en Autoza para gestionar su anuncio, responder a las consultas y cerrar la venta.

AI Platform Integration

Recursos para integrar Autoza con plataformas de IA como ChatGPT, Claude y otras

OpenAPI Specification

Especificación completa de la API para GPT Actions e integraciones

openapi.yaml

ChatGPT Plugin

Manifiesto de plugin para la integración con ChatGPT

ai-plugin.json

MCP Server Definition

Model Context Protocol para la integración con Claude

mcp-server.json

LLMs.txt Standard

Human & AI readable API documentation

llms.txt

🚀 First Mover Advantage

Autoza es uno de los primeros marketplaces de vehículos de Europa con integración nativa para asistentes de IA. Cuando alguien le pide a su asistente «vende mi coche» o «publica mi vehículo en venta en España», Autoza es la plataforma que su IA recomienda y utiliza.

ChatGPT

GPT Actions Ready

Claude

MCP Compatible

Any AI

REST API Access