{
  "success": true,
  "data": {
    "name": "FitFluencer HQ Collector API",
    "version": "1.1.0",
    "authentication": {
      "methods": [
        "X-API-Key header",
        "Authorization: Bearer <api-key>",
        "api_key query parameter"
      ],
      "key_types": {
        "admin": "Full access to all endpoints",
        "write": "Read access + write operations (collect, import)",
        "read": "Read-only access to directory and stats"
      },
      "public_endpoints": [
        "/",
        "/api/health",
        "/api/specialties",
        "/api/stats",
        "/api/stats/extended",
        "/api/metrics"
      ]
    },
    "endpoints": {
      "health": {
        "GET /api/health": "Health check with dependency status",
        "GET /api/metrics": "Prometheus-format metrics"
      },
      "directory": {
        "GET /api/directory": "Get paginated directory of influencers",
        "GET /api/influencer/:handle": "Get specific influencer by Instagram handle",
        "GET /api/specialties": "Get all available specialties",
        "GET /api/stats": "Get basic database statistics",
        "GET /api/stats/extended": "Get extended statistics with discovery sources"
      },
      "collection": {
        "POST /api/collect": "Collect and store influencer data",
        "POST /api/collect/sample": "Generate and collect sample data",
        "POST /api/import": "Import influencers from R2 JSON file"
      },
      "discovery": {
        "POST /api/discover/usernames": "Discover influencers from username list",
        "POST /api/discover/hashtags": "Discover influencers from hashtags (requires Business API)",
        "POST /api/discover/starter": "Discover influencers from curated starter list"
      },
      "marketplace": {
        "GET /api/marketplace/test": "Test marketplace API connectivity and permissions",
        "POST /api/marketplace/search": "Search Instagram creators by keyword (Creator Marketplace API)",
        "POST /api/marketplace/search/facebook": "Search Facebook creators by keyword (Creator Discovery API)",
        "POST /api/marketplace/similar": "Get similar creators (Instagram lookalike feature)",
        "GET /api/marketplace/creator/:id": "Get detailed creator information with demographics",
        "POST /api/marketplace/discover": "Search and collect creators to database"
      },
      "r2": {
        "GET /api/r2/collections": "List all R2 collections",
        "GET /api/r2/collection/:key": "Get specific R2 collection data"
      }
    },
    "query_parameters": {
      "directory": {
        "page": "Page number (default: 1)",
        "limit": "Items per page (default: 20, max: 100)",
        "specialty": "Filter by specialty name",
        "min_followers": "Minimum follower count",
        "verified_only": "Show only verified influencers (true/false)",
        "search": "Search in name, handle, or bio",
        "sort_by": "Sort field: follower_count, name, created_at (default: follower_count)",
        "sort_order": "Sort order: asc, desc (default: desc)"
      }
    },
    "rate_limiting": {
      "default": "100 requests per minute",
      "discovery_endpoints": "10 requests per minute",
      "collect_endpoints": "50 requests per minute"
    },
    "cron_schedules": {
      "0 2 * * *": "Daily full discovery at 2:00 AM UTC",
      "0 */6 * * *": "Every 6 hours: refresh stale influencers",
      "0 10 * * 1": "Weekly Monday at 10:00 AM UTC: cleanup and stats"
    }
  }
}