JCDecaux Bike

{
  "service_type": "platform",
  "base_url": "https://developer.jcdecaux.com",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "JCDecaux Developer Portal provides an API key for accessing the bike sharing data. The key is typically passed as a query parameter or in headers. Refer to the official documentation for exact placement."
  },
  "endpoints": [
    {
      "path": "/vls/v1/stations",
      "method": "GET",
      "description": "List all bike stations for a specific contract (city). Parameters: contract (required), apiKey (required)."
    },
    {
      "path": "/vls/v1/stations/{station_id}",
      "method": "GET",
      "description": "Get details of a specific station including available bikes and stands. Parameters: contract, station_id, apiKey."
    },
    {
      "path": "/vls/v1/contracts",
      "method": "GET",
      "description": "List all available contracts (cities) with their metadata. Parameters: apiKey."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Free access to the bike sharing API with a registered API key. No premium tier is publicly documented."
    }
  },
  "rate_limits": {
    "requests_per_day": "Not publicly documented but typical for such services, likely 1000-10000 per day. Details on the developer portal."
  },
  "capabilities": [
    "Real-time bike station status",
    "Station availability (bikes and stands)",
    "Station location and metadata",
    "Contract listing for supported cities",
    "Integration with smart city applications",
    "Public transportation planning"
  ],
  "raw_analysis": "JCDecaux is a major outdoor advertising and urban furniture company, and its self-service bicycle sharing system operates in many cities worldwide. The developer portal provides a public API that exposes real-time station status, including available bikes and docking spaces. This API is well-documented and is used by many third-party integrations such as mobility apps, city dashboards, and transit planners. The service is mature, launched in 2007, and has a broad user base including developers of transportation and smart city applications. The API is RESTful and uses a simple API key for authentication, making it easy to integrate. It does not have an official SDK but there are many community libraries. The platform also offers an open data feed for some cities, but the primary method is the API. The pricing model is freemium; the API is free to use with a registered key, and there is no publicly documented premium tier, making it accessible to hobbyists and commercial projects alike. Rate limits are not explicitly documented but are typically reasonable for non-commercial use. Overall, JCDecaux's bike API is a solid, reliable, and widely adopted platform for accessing urban bike-sharing data."
}

2/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 7.0,
    "first_try_success": 6.0,
    "response_parseability": 8.5,
    "error_clarity": 6.5,
    "doc_quality": 7.0,
    "auth_simplicity": 8.0,
    "latency": 8.0,
    "consistency": 7.5
  },
  "pricing_normalized": {
    "model": "freemium",
    "free_tier": "Full API access with registered key",
    "premium_tier": "None publicly documented",
    "cost_estimate": "Free for basic use, enterprise pricing unknown"
  },
  "issues": [
    "No /llms.txt file found — limits agent-friendly discovery",
    "Premium tier details not documented, scalability unclear",
    "Registration flow not fully visible from checks — likely requires email signup with human verification",
    "Limited documentation on rate limits or usage policies"
  ],
  "recommendations": [
    "Add /llms.txt with API endpoint descriptions and code examples",
    "Publish explicit rate limits and terms for automated access",
    "Consider adding OAuth or API-key auto-generation for smoother agent onboarding",
    "Document city coverage and data freshness guarantees"
  ]
}
```