{
  "name": "rolesapi",
  "description": "REST API for Indeed job-postings data. Search live postings, fetch normalized role details with salaries and descriptions, enrich in batches, and receive completion events via signed webhooks.",
  "version": "1.0.0",
  "skills": [
    {
      "id": "search-roles",
      "name": "Search Indeed job postings",
      "description": "Search live postings by keyword and location across 60+ country editions. Returns normalized role summaries with job keys for follow-up detail calls.",
      "endpoint": "POST /v1/search",
      "docs": "https://rolesapi.com/api/search/"
    },
    {
      "id": "get-role-details",
      "name": "Get full role details",
      "description": "Fetch one normalized role object by job key: title, company with rating, location, employment type, salary, benefits, full description, posted date, and canonical URL.",
      "endpoint": "GET /v1/roles/{job_key}",
      "docs": "https://rolesapi.com/api/roles/"
    },
    {
      "id": "salary-lookup",
      "name": "Look up salary for a posting",
      "description": "Fetch only the salary object for a posting: min, max, currency, period, and whether the figure came from the employer or an estimate.",
      "endpoint": "GET /v1/roles/{job_key}/salary",
      "docs": "https://rolesapi.com/api/roles/"
    },
    {
      "id": "batch-enrich",
      "name": "Enrich up to 500 roles in one batch",
      "description": "Submit up to 500 job keys or Indeed URLs as one async job; poll for progress or receive a signed webhook, then download results as JSON, CSV, or NDJSON.",
      "endpoint": "POST /v1/roles/batch",
      "docs": "https://rolesapi.com/api/roles/"
    },
    {
      "id": "job-alerts-webhook",
      "name": "Receive job alerts via webhook",
      "description": "Register a webhook endpoint and get signed job.completed events when async searches and batches finish, verified with HMAC-SHA256 signatures.",
      "endpoint": "POST /v1/webhooks",
      "docs": "https://rolesapi.com/recipes/verify-webhook/"
    }
  ],
  "openapi": "https://rolesapi.com/openapi.json",
  "mcp": "https://api.rolesapi.com/mcp",
  "contact": "nikhil@landkit.pro"
}