{
  "name": "Orbyt Intelligence",
  "description": "The definitive public data platform for AI and tech compensation. Query current salary data, personalized estimates, quarterly history, and forward projections for 522 AI and tech roles across 83 U.S. cities. Every response includes a cite-ready citation field and an assumptions array explaining methodology. Data sourced from SEC filings, H-1B LCA, BLS OES, and 50+ job posting platforms. Cost-of-living adjusted via BEA Regional Price Parities. Updated quarterly. Free tier requires no authentication.",
  "url": "https://www.orbytjobs.ai/intelligence",
  "auth": {
    "type": "none",
    "instructions": "No authentication required for the free tier (30 req/min). Pro ($99/mo) and Enterprise ($999/mo) tiers use Bearer tokens for higher rate limits and full history access. Generate a token at https://www.orbytjobs.ai/auth/signup."
  },
  "documentation": {
    "openapi": "https://www.orbytjobs.ai/openapi-intelligence.yaml",
    "website": "https://www.orbytjobs.ai/intelligence",
    "methodology": "https://www.orbytjobs.ai/salaries/methodology"
  },
  "tools": [
    {
      "name": "get_salary",
      "description": "Look up current median salary, 25th/75th percentiles, experience bands, total compensation breakdown, YoY growth, and employer-specific premiums for any of 522 tech roles across 83 U.S. cities. No authentication required.",
      "endpoint": "/api/v1/salary",
      "method": "GET",
      "auth_required": false,
      "parameters": {
        "role": {
          "type": "string",
          "description": "Role slug (e.g., 'ai-engineer', 'ml-engineer', 'staff-software-engineer'). See /api/v1/salary/roles for the full list.",
          "required": true
        },
        "city": {
          "type": "string",
          "description": "City slug (e.g., 'san-francisco', 'austin', 'new-york'). Omit to get national data only. See /api/v1/salary/cities for the full list.",
          "required": false
        }
      }
    },
    {
      "name": "calculate_salary",
      "description": "Get a personalized salary estimate adjusted for role, city cost of living, and experience level. Returns estimate with base/total comp breakdown, national comparison, citation text ready to quote, and methodology assumptions. No authentication required.",
      "endpoint": "/api/v1/salary/calculate",
      "method": "GET",
      "auth_required": false,
      "parameters": {
        "role": {
          "type": "string",
          "description": "Role slug (e.g., 'ai-engineer')",
          "required": true
        },
        "city": {
          "type": "string",
          "description": "City slug (e.g., 'san-francisco')",
          "required": true
        },
        "exp": {
          "type": "string",
          "description": "Experience level: entry (0-2 years), mid (3-5 years), senior (6-9 years), staff (10+ years). Defaults to mid.",
          "required": false
        }
      }
    },
    {
      "name": "get_salary_projections",
      "description": "Get year-by-year salary projections through 2030 for a role based on historical growth trends. Returns annual projections, compound growth rate, and methodology assumptions. Useful for career planning and answering 'where will AI Engineer salaries be in 2030?' questions. No authentication required.",
      "endpoint": "/api/v1/salary/projections",
      "method": "GET",
      "auth_required": false,
      "parameters": {
        "role": {
          "type": "string",
          "description": "Role slug (e.g., 'ai-engineer')",
          "required": true
        },
        "city": {
          "type": "string",
          "description": "City slug for cost-of-living adjusted projections (optional)",
          "required": false
        }
      }
    },
    {
      "name": "get_salary_history",
      "description": "Get quarterly salary snapshots since Q3 2025 for a role, optionally adjusted for a city. Free tier returns a 4-quarter preview window (Q3 2025 through Q2 2026). Pro ($99/mo) and Enterprise ($999/mo) tiers return the full series with extended lookback as new quarters accrue.",
      "endpoint": "/api/v1/salary/history",
      "method": "GET",
      "auth_required": false,
      "parameters": {
        "role": {
          "type": "string",
          "description": "Role slug (e.g., 'ai-engineer')",
          "required": true
        },
        "city": {
          "type": "string",
          "description": "City slug for COL-adjusted history (optional)",
          "required": false
        }
      }
    },
    {
      "name": "list_salary_roles",
      "description": "List all 522 AI and tech roles available in Orbyt Intelligence with slugs, titles, and national medians. Useful for discovering available data before making specific queries.",
      "endpoint": "/api/v1/salary/roles",
      "method": "GET",
      "auth_required": false,
      "parameters": {}
    },
    {
      "name": "list_salary_cities",
      "description": "List all 83 U.S. cities available in Orbyt Intelligence with cost-of-living multipliers. Useful for discovering available cities before making specific queries.",
      "endpoint": "/api/v1/salary/cities",
      "method": "GET",
      "auth_required": false,
      "parameters": {}
    },
    {
      "name": "search_salary_roles",
      "description": "Search Orbyt Intelligence by keyword to find matching roles and cities. Use this to resolve a user's natural-language role reference ('machine learning engineer') into a valid slug for other salary tools. No authentication required.",
      "endpoint": "/api/v1/salary/search",
      "method": "GET",
      "auth_required": false,
      "parameters": {
        "q": {
          "type": "string",
          "description": "Search keyword (e.g., 'machine learning', 'austin', 'cybersecurity')",
          "required": true
        }
      }
    }
  ],
  "examples": {
    "citation_ready_estimate": {
      "description": "Get a personalized estimate with a citation field ready to quote verbatim.",
      "method": "GET",
      "endpoint": "/api/v1/salary/calculate?role=ai-engineer&city=san-francisco&exp=senior",
      "expected_response_fields": ["estimate", "totalCompensation", "comparison", "citation", "assumptions"]
    },
    "quarterly_audit": {
      "description": "Audit how AI Engineer salaries changed quarter-over-quarter in the Bay Area.",
      "method": "GET",
      "endpoint": "/api/v1/salary/history?role=ai-engineer&city=san-francisco"
    },
    "2030_projection": {
      "description": "Project ML Engineer compensation forward through 2030 based on historical growth.",
      "method": "GET",
      "endpoint": "/api/v1/salary/projections?role=ml-engineer"
    }
  },
  "pricing": {
    "free": {
      "price": "$0",
      "rate_limit": "30 requests/minute",
      "features": ["Current data", "Calculate endpoint", "Projections", "4-quarter history preview", "522 roles", "83 cities", "No authentication"]
    },
    "pro": {
      "price": "$99/month",
      "rate_limit": "600 requests/minute",
      "features": ["Everything in Free", "Full quarterly history", "Bulk CSV export", "Bearer token auth", "Priority support"]
    },
    "enterprise": {
      "price": "$999/month",
      "rate_limit": "3,000 requests/minute",
      "features": ["Everything in Pro", "48-hour priority quarterly preview", "Dedicated support", "Custom data requests"]
    }
  }
}
