Mercadolibre API

{
  "service_type": "platform",
  "base_url": "https://api.mercadolibre.com",
  "auth_method": "oauth2",
  "auth_config": {
    "authorization_url": "https://auth.mercadolibre.cl/authorization",
    "token_url": "https://api.mercadolibre.com/oauth/token",
    "scopes": ["offline_access", "read", "write"],
    "flow": "authorization_code",
    "pkce": false,
    "notes": "OAuth 2.0 with app registration in Mercado Libre Developers portal. Access tokens expire (typically 6 hours), refresh tokens used for renewal. Also supports client_credentials for some public endpoints."
  },
  "endpoints": [
    "GET /sites",
    "GET /sites/{site_id}",
    "GET /sites/{site_id}/search",
    "GET /items/{item_id}",
    "GET /items?ids={ids}",
    "POST /items",
    "PUT /items/{item_id}",
    "GET /users/{user_id}",
    "GET /users/me",
    "GET /users/{user_id}/items/search",
    "GET /orders/{order_id}",
    "GET /orders/search",
    "GET /questions/{question_id}",
    "GET /questions/search",
    "POST /answers",
    "GET /categories/{category_id}",
    "GET /categories/{category_id}/attributes",
    "GET /currencies",
    "GET /countries/{country_id}",
    "GET /shipments/{shipment_id}",
    "GET /trends/{site_id}",
    "POST /oauth/token"
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "api_access": "free for developers and sellers (Mercado Libre charges commission on transactions, not API usage)",
      "marketplace_fees": "sellers pay listing fees and final value fees depending on category and listing type",
      "notes": "API itself is not separately monetized; costs tied to marketplace/shipping operations."
    }
  },
  "rate_limits": {
    "default": "Approximately 10 requests per second per application/user (varies), burst limits apply",
    "throttling_behavior": "HTTP 429 responses with Retry-After header",
    "documented": "Mercado Libre publishes rate limit guidance; exact values can change per endpoint and app tier"
  },
  "capabilities": [
    "marketplace listing management (create, update, pause, close items)",
    "product search across Mercado Libre sites (18+ Latin American countries)",
    "order and sales management",
    "buyer-seller messaging (questions and answers)",
    "inventory and stock synchronization via feeds",
    "shipping and fulfillment integration (Mercado Envíos)",
    "category and attribute taxonomy browsing",
    "user and reputation data",
    "authentication and user authorization (OAuth 2.0)",
    "webhooks/notifications for item, order, and question events",
    "trends and analytics data",
    "multi-country site support (MLA AR, MLB BR, MLM MX, MLC CL, MCO CO, etc.)"
  ],
  "raw_analysis": "Mercado Libre (mercadolibre.cl is the Chilean storefront) is Latin America's largest e-commerce and fintech platform, operating in 18+ countries. This entry refers to the Mercado Libre public developer API (api.mercadolibre.com), which is a stable, well-documented RESTful platform with OAuth 2.0 authentication and a rich ecosystem of SDKs and community libraries.\n\nThe API is mature (operating for over a decade) and widely used by sellers, integrators, ERP providers, and third-party marketplaces. It covers the full commerce lifecycle: listings, orders, payments (via Mercado Pago), shipping, messaging, and analytics. Endpoints are JSON-based and region-aware via site IDs (MLC for Chile, MLA, MLB, MLM, etc.). Documentation lives at developers.mercadolibre.com with per-country portals.\n\nMaturity is high: OAuth 2.0 with refresh tokens, rate limiting with standard 429 semantics, webhook notifications, sandbox/test users, and dedicated support for the Developer Partner Program. There is no separate per-call pricing; API access is free, with business economics tied to marketplace transaction fees (listing fees, final value fees, Mercado Pago processing). Rate limits are enforced per application and per user, generally in the ~10 rps range with bursts and Retry-After on throttling. Integration options include REST directly, official/community SDKs (Java, .NET, PHP, Python, Node), and no-code connectors (Shopify, WooCommerce, PrestaShop, ERP systems)."
}

1/3 tests passed

```json
{
  "overall": 74,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.0,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 7.5,
    "auth_simplicity": 7.5,
    "latency": 9.5,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "api_cost": "free",
    "transaction_fees": "variable (listing + final value fees, category-dependent)",
    "agent_consideration": "No per-call API cost — favorable for agent usage; but downstream seller fees must be surfaced to users"
  },
  "issues": [
    "No llms.txt — agents lack a machine-readable entry point describing the platform",
    "robots.txt disallows all agents (Disallow: /), which degrades automated discovery even though the API itself is separate",
    "Root API endpoints return 404 with a Spanish-language error, reducing machine clarity for English-context agents",
    "Documentation is split between developers.mercadolibre.com and site-specific portals — onboarding requires redirects",
    "OAuth 2.0 flow requires redirect URIs and app registration, adding friction vs. magic-link/notlogin-style onboarding",
    "Multi-country site taxonomy (18+ domains) increases complexity for agents recommending cross-region use"
  ],
  "recommendations": [
    "Publish an llms.txt at developers.mercadolibre.com summarizing API surface, auth, and country endpoints for agent consumption",
    "Allow agents to crawl the developer docs (relax robots.txt for developers.* subdomain) to improve discoverability",
    "Provide structured OpenAPI/JSON schema manifests so agents can parse capabilities without scraping HTML",
    "Offer a sandbox/test-user flow that completes in under 5 minutes without human review",
    "Return errors in a stable machine-readable format (e.g., {code, message, details}) with English support",
    "Consider a simplified agent onboarding (delegated token via verified identity) alongside OAuth for autonomous flows",
    "Expose a single 'capabilities' discovery endpoint returning supported countries, categories, and rate limits"
  ]
}
```