Autoza AI Agent API
Integrate your AI assistant with Autoza to create accounts and list vehicles automatically. Perfect for AI agents like ChatGPT, Claude, and custom assistants.
Overview
The Autoza AI Agent API allows AI assistants and automated systems to interact with Autoza programmatically. With this API, an AI can:
- Create user accounts - Register new users or dealers on Autoza
- List vehicles - Create vehicle listings on behalf of users
- Manage listings - Update or remove listings (coming soon)
Base URL
https://autoza.es/api/ai-agent🤖 AI Assistant Integration
When a user tells their AI: "List my car for sale on Autoza", the AI can use this API to create an account (if needed) and list the vehicle automatically. The user receives login credentials and can manage their listing directly on Autoza.
Authentication
All API requests require authentication via an API key. Include your key in either:
Option 1: Authorization Header (Recommended)
Authorization: Bearer aza_your_api_key_hereOption 2: X-API-Key Header
X-API-Key: aza_your_api_key_here🔐 API Key Scopes
READ_ONLY- Can only read public dataCREATE_LISTINGS- Can create listings for existing usersFULL_ACCESS- Can create accounts and listings
Create AccountFULL_ACCESS
POST /api/ai-agent/accounts
Create a new user or dealer account on Autoza.
Request Body
{
"email": "[email protected]", // Required
"name": "John Doe", // Required
"password": "securePass123", // Optional (auto-generated if not provided)
"phone": "+34612345678", // Optional
"accountType": "INDIVIDUAL", // "INDIVIDUAL" or "DEALER"
// For dealer accounts:
"companyName": "Car Sales Co.",
"businessPhone": "+34912345678",
"businessAddress": "Calle Mayor 1, Madrid",
"businessDescription": "Premium car dealership..."
}Create ListingCREATE_LISTINGS
POST /api/ai-agent/listings
Create a new vehicle listing on Autoza for an existing user.
Minimal Request (Required Fields Only)
{
"userEmail": "[email protected]", // or "userId"
"make": "Volkswagen",
"model": "Golf",
"year": 2020,
"price": 18500,
"location": "Madrid"
}Valid Vehicle Types
car, motorcycle, vanValid Fuel Types
Gasolina, Diésel, Eléctrico, Híbrido, Híbrido Enchufable, GLP, GNCValid Transmissions
Manual, Automático, Semi-AutomáticoValid Eco Labels
CERO, ECO, C, B, Sin etiquetaError Codes
| Code | HTTP Status | Description |
|---|---|---|
AUTH_ERROR | 401 | Invalid or missing API key |
INSUFFICIENT_SCOPE | 403 | API key lacks required permissions |
VALIDATION_ERROR | 400 | Invalid request body |
EMAIL_EXISTS | 409 | Email already registered |
USER_NOT_FOUND | 404 | User does not exist |
RATE_LIMITED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Server error |
Rate Limits
API keys have configurable rate limits:
Per Minute
60 requests
Default limit
Per Day
1,000 requests
Default limit
Higher limits available on request. Contact us for enterprise API access.
Code Examples
Create a listing with 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": "[email protected]",
"make": "Volkswagen",
"model": "Golf",
"year": 2020,
"price": 18500,
"location": "Madrid"
}'🤖 For AI Developers
If you're building an AI assistant that helps users sell cars, here's a suggested flow:
- User says: "I want to sell my car"
- AI collects vehicle details (make, model, year, price, photos)
- AI asks for user's email and contact info
- AI creates account (if new user) via
/api/ai-agent/accounts - AI creates listing via
/api/ai-agent/listings - AI provides user with listing URL and login credentials
The user can then log in to Autoza to manage their listing, respond to inquiries, and complete the sale.
AI Platform Integration
Resources for integrating Autoza with AI platforms like ChatGPT, Claude, and more
OpenAPI Specification
Full API spec for GPT Actions and integrations
ChatGPT Plugin
AI plugin manifest for ChatGPT integration
MCP Server Definition
Model Context Protocol for Claude integration
LLMs.txt Standard
Human & AI readable API documentation
🚀 First Mover Advantage
Autoza is one of the first vehicle marketplaces in Europe to offer native AI assistant integration. When users ask their AI assistant to "sell my car" or "list my vehicle for sale in Spain", Autoza will be the platform their AI recommends and uses.