Recreation Information Database

{
  "service_type": "platform",
  "base_url": "https://ridb.recreation.gov",
  "auth_method": "api_key",
  "auth_config": {
    "api_key_header": "X-Api-Key",
    "api_key_location": "header",
    "description": "API key required. Obtain from https://ridb.recreation.gov/ (register for a key)."
  },
  "endpoints": [
    {
      "path": "/api/v1/",
      "method": "GET",
      "description": "Root endpoint, returns API metadata."
    },
    {
      "path": "/api/v1/recareas",
      "method": "GET",
      "description": "List recreation areas with optional filters (limit, offset, query, state, activity, etc.)"
    },
    {
      "path": "/api/v1/recareas/{id}",
      "method": "GET",
      "description": "Get details for a specific recreation area."
    },
    {
      "path": "/api/v1/recareas/{id}/facilities",
      "method": "GET",
      "description": "List facilities within a recreation area."
    },
    {
      "path": "/api/v1/recareas/{id}/recreationactivities",
      "method": "GET",
      "description": "List recreation activities available at a recreation area."
    },
    {
      "path": "/api/v1/recareas/{id}/events",
      "method": "GET",
      "description": "List events at a recreation area."
    },
    {
      "path": "/api/v1/recareas/{id}/media",
      "method": "GET",
      "description": "List media (photos/videos) for a recreation area."
    },
    {
      "path": "/api/v1/facilities",
      "method": "GET",
      "description": "List facilities with optional filters (limit, offset, query, state, activity, etc.)"
    },
    {
      "path": "/api/v1/facilities/{id}",
      "method": "GET",
      "description": "Get details for a specific facility."
    },
    {
      "path": "/api/v1/facilities/{id}/recareas",
      "method": "GET",
      "description": "List recreation areas associated with a facility."
    },
    {
      "path": "/api/v1/facilities/{id}/recreationactivities",
      "method": "GET",
      "description": "List recreation activities available at a facility."
    },
    {
      "path": "/api/v1/facilities/{id}/events",
      "method": "GET",
      "description": "List events at a facility."
    },
    {
      "path": "/api/v1/facilities/{id}/media",
      "method": "GET",
      "description": "List media for a facility."
    },
    {
      "path": "/api/v1/activities",
      "method": "GET",
      "description": "List all recreation activities."
    },
    {
      "path": "/api/v1/activities/{id}",
      "method": "GET",
      "description": "Get details for a specific activity."
    },
    {
      "path": "/api/v1/organizations",
      "method": "GET",
      "description": "List organizations (agencies) that manage facilities/areas."
    },
    {
      "path": "/api/v1/organizations/{id}",
      "method": "GET",
      "description": "Get details for a specific organization."
    },
    {
      "path": "/api/v1/organizations/{id}/recareas",
      "method": "GET",
      "description": "List recreation areas managed by an organization."
    },
    {
      "path": "/api/v1/organizations/{id}/facilities",
      "method": "GET",
      "description": "List facilities managed by an organization."
    },
    {
      "path": "/api/v1/tours",
      "method": "GET",
      "description": "List tours available at facilities (e.g., cave tours)."
    },
    {
      "path": "/api/v1/tours/{id}",
      "method": "GET",
      "description": "Get details for a specific tour."
    },
    {
      "path": "/api/v1/tours/{id}/facilities",
      "method": "GET",
      "description": "List facilities offering a tour."
    },
    {
      "path": "/api/v1/campsites",
      "method": "GET",
      "description": "List campsites within a facility (requires facilityId parameter)."
    },
    {
      "path": "/api/v1/campsites/{id}",
      "method": "GET",
      "description": "Get details for a specific campsite."
    },
    {
      "path": "/api/v1/permits",
      "method": "GET",
      "description": "List permits available (e.g., recreational permits)."
    },
    {
      "path": "/api/v1/permits/{id}",
      "method": "GET",
      "description": "Get details for a specific permit."
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "license": "U.S. Government Open Data, public domain",
      "api_key": "Free API key registration required",
      "usage_limits": "No explicit pricing, fair use expected"
    }
  },
  "rate_limits": {
    "default": "Not documented explicitly, but recommends caching and using conditional requests",
    "suggestion": "10 requests per second (not confirmed, but typical for government APIs)"
  },
  "capabilities": [
    "Search recreation areas, facilities, and activities",
    "Filter by state, activity, and agency",
    "Get detailed information on facilities (campgrounds, visitor centers, etc.)",
    "List events and media associated with recreation sites",
    "Access organizational data (managing agencies)",
    "Discover tours and permits",
    

3/3 tests passed

```json
{
  "overall": 78,
  "dimensions": {
    "token_efficiency": 9.0,
    "first_try_success": 8.0,
    "response_parseability": 10.0,
    "error_clarity": 8.0,
    "doc_quality": 9.0,
    "auth_simplicity": 7.0,
    "latency": 9.3,
    "consistency": 8.5
  },
  "pricing_normalized": {
    "cost_per_request": 0,
    "currency": "USD",
    "tier": "free",
    "api_key_required": true,
    "rate_limits": "No explicit limits, fair use expected",
    "license": "U.S. Government Open Data, public domain"
  },
  "issues": [
    "No llms.txt file — the response for llms.txt check returned the main HTML page instead of a machine-readable spec",
    "robots.txt disallows /api paths, conflicting with API-first usage — agents may be confused about whether direct API calls are permitted",
    "Requires free API key registration, which adds a small signup barrier"
  ],
  "recommendations": [
    "Add an llms.txt endpoint with structured API documentation for AI agents",
    "Update robots.txt to allow /api for legitimate automated clients (or clarify that RIDB API usage is governed separately from website crawling)",
    "Provide public API schema in OpenAPI format to reduce onboarding friction"
  ]
}
```