MotoRevista CR Developer Resources
Welcome to the developer and AI agent resource center for MotoRevista CR — Costa Rica’s leading motorcycle, power sports, and automotive publication. This portal provides comprehensive technical specifications, machine-readable indexes, and programmatic access endpoints.
Full machine-readable REST API schema with typed RFC 9457 Problem Details error models.
Curated agent navigation, operational guidelines, data trust rules, and full catalog indexes.
Markdown Content Negotiation (RFC 9110)
All public pages on MotoRevista CR, including the homepage (https://www.motorevistacr.com/), support native HTTP content negotiation. When requesting a page with Accept: text/markdown, the origin returns pure, semantic Markdown rather than HTML.
curl -sS -L -H "Accept: text/markdown" https://www.motorevistacr.com/Negotiation Rules: Respects quality weights (q-values), wildcard specificity, and emits Vary: Accept. Clients sending non-acceptable media types receive an RFC 9457 406 Not Acceptable response.
Public REST API Endpoints
Base URL: https://www.motorevistacr.com/api/v1 (No authentication required for read-only access).
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/motorcycles | Paginated marketplace catalog with brand, category, and price filters. |
| GET | /api/v1/vehicles | Unified catalog covering motorcycles, ATVs, and UTVs. |
| GET | /api/v1/vehicles/{slug} | Detailed vehicle record, verified pricing, and technical specifications. |
| GET | /api/v1/posts | Recent editorial articles, launch coverage, and tech specs. |
| GET | /api/v1/categories | Taxonomy categories and article counts. |
| GET | /api/v1/search?q={term} | Full-text search across titles and keywords. |
Typed Error Model (RFC 9457 Problem Details)
All API error responses use the media type application/problem+json. Each response contains machine-readable error codes and human-readable resolution guidance:
{
"type": "https://www.motorevistacr.com/problems/invalid-param",
"title": "Invalid query filter parameters.",
"status": 400,
"detail": "Adjust the query parameters to match the schema defined in /openapi.json.",
"code": "INVALID_PARAM",
"documentation_url": "https://www.motorevistacr.com/developers",
"instance": "/api/v1/vehicles",
"errors": {
"page": { "_errors": ["Number must be greater than or equal to 1"] }
}
}Official CLI Tool
The MotoRevista CR command-line interface provides read-only inspection of articles, technical specifications, marketplace models, and OpenAPI schemas directly from the terminal.
Rate Limiting & Advisory Headers
Public requests are subject to an advisory rate limit of 60 requests per minute per IP. Standard IETF headers are provided on every response:
RateLimit-Limit: Total allowed requests per window (60)RateLimit-Remaining: Remaining quota in the current windowRateLimit-Reset: Epoch timestamp when the quota resetsRetry-After: Number of seconds to wait if a 429 status code is received


