Purple Air

{
  "service_type": "platform",
  "base_url": "https://www2.purpleair.com",
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": "Public access to real-time air quality data from PurpleAir sensors via web map and public API.",
      "paid": "Hardware sensors (e.g., PurpleAir PA-II, PA-II-SD) for purchase; premium data features for organizations via partnership or enterprise plans."
    }
  },
  "rate_limits": {
    "public_api": "No explicit rate limits documented publicly; API access is typically free for non-commercial use, but heavy usage may be restricted. The API endpoint for sensor data is fetch-based and may have practical limits (e.g., request frequency)."
  },
  "capabilities": [
    "Real-time air quality monitoring (PM2.5, PM10, AQI)",
    "Public map visualization of air quality data",
    "Public API for sensor data retrieval (via HTTPS GET requests)",
    "Historical data access (via API with date/time ranges)",
    "Integration with Google Maps and other mapping services",
    "Email alerts (for registered users, hardware owners)",
    "Data export (CSV) for registered sensor owners",
    "Community/network of citizen-science sensors",
    "Webhook support (via third-party integrations, e.g., Home Assistant)"
  ],
  "raw_analysis": "PurpleAir is a platform for real-time air quality monitoring, primarily focused on PM2.5 and PM10 particulate matter. It provides a public web map (www2.purpleair.com) displaying data from a large network of low-cost IoT sensors, primarily owned by citizens and small organizations. The platform offers a free public API to fetch sensor data (e.g., /maps/v1/sensors) for non-commercial use, but authentication is not required for basic public data. For commercial or heavy use, there is a paid 'data partnership' program. The platform is mature, with a large community (over 10,000 sensors worldwide) and integrations with home automation (Home Assistant, Node-RED) and weather services. It is popular among environmentalists, researchers, and health-conscious individuals. However, it lacks a formal authentication mechanism for public API, so data access is open. The platform does not provide a query-based endpoint like RESTful CRUD; instead, it offers specific API endpoints for sensors, maps, and statistics. There is no official documentation for rate limits, but the API is designed for moderate use; heavy scraping is discouraged. "
}

2/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 6.0,
    "response_parseability": 7.5,
    "error_clarity": 4.5,
    "doc_quality": 6.5,
    "auth_simplicity": 7.0,
    "latency": 9.5,
    "consistency": 8.5
  },
  "pricing_normalized": {
    "free_tier": "Public real-time and historical data API access; no authentication required for basic queries",
    "paid_tier": "Hardware sensors required for contributing data; enterprise/partnership plans for premium features",
    "note": "Core data API is free and open; monetization via hardware sales and organizational partnerships"
  },
  "issues": [
    "No llms.txt file found (404) - AI discoverability limited",
    "Robots.txt disallows /api/ traversal, but allows specific API endpoints - may confuse automated clients",
    "Lack of explicit rate limit documentation in available metadata",
    "No clear API authentication documentation surfaced in the analyzed response",
    "Free tier lacks alerting for non-hardware owners - data consumers cannot receive notifications without purchasing hardware"
  ],
  "recommendations": [
    "Add an /llms.txt file with API endpoint documentation, usage policies, and data schema examples",
    "Publish explicit API rate limits and pagination details in a public doc page",
    "Clarify authentication model - distinguish between no-auth public endpoints and key-based access for higher-tier features",
    "Provide a quick-start guide for querying AQI data by city or sensor ID without hardware ownership",
    "Document CSV export process for public data - currently only mentioned for hardware owners"
  ]
}
```