RoleDawn

Use when the user wants companies to prospect or watch because they just began hiring for a function, e.g. "companies hiring their first SDR this week" or "who started a RevOps or security team". Returns up to 20 companies per call, each with job title, location, job URL, posted and detected dates. first_hire = first role of that family on their own careers page; surge = clearly more roles than the prior 30 days. For one known company's jobs use list_company_jobs.

{
  "type": "object",
  "properties": {
    "family": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z-]+$"
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "Role family ids (1-5). Common: sdr (SDR/BDR), sales (AEs), revops, customer-success, marketing, security, data-engineering, ml-ai. All ids: sdr, sales, revops, sales-enablement, marketing-ops, sales-engineering, partnerships, customer-success, account-management, support, professional-services, marketing, product-marketing, growth-marketing, content, devrel, community, software-engineering, frontend, mobile, platform-sre, security, compliance, qa, engineering-management, hardware, it, data-engineering, data-analytics, ml-ai, product-management, design, ux-research, technical-writing, finance, legal, people, recruiting, bizops, workplace, executive, clinical, supply-chain.",
      "examples": [
        [
          "sdr"
        ],
        [
          "revops",
          "sales-enablement"
        ]
      ]
    },
    "since": {
      "type": "string",
      "enum": [
        "7d",
        "14d",
        "30d"
      ],
      "description": "Detected in the last 7, 14 or 30 days. Default 7d."
    },
    "type": {
      "type": "string",
      "enum": [
        "first_hire",
        "surge",
        "all"
      ],
      "description": "first_hire (default) = first role of the family; surge = hiring jump; all = both."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Companies per page (1-20). Default 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 19,
      "description": "Companies to skip; use next_offset from the previous result."
    }
  },
  "required": [
    "family"
  ],
  "additionalProperties": false
}

Use when the user names a company and wants its current open roles, e.g. "is Stripe hiring engineers in London?" or "list this company's remote jobs". Reads the public Greenhouse, Lever or Ashby job board and returns title, location, department, remote flag, job URL and posting date, newest first. company = board slug (stripe in boards.greenhouse.io/stripe); if not found on one ATS, retry the other two. For companies newly hiring across the market use list_hiring_signals.

{
  "type": "object",
  "properties": {
    "ats": {
      "type": "string",
      "enum": [
        "greenhouse",
        "lever",
        "ashby"
      ],
      "description": "Applicant tracking system that hosts the job board. Unknown? Try greenhouse, then lever, then ashby."
    },
    "company": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$",
      "description": "Job-board slug from the careers URL, e.g. stripe.",
      "examples": [
        "stripe"
      ]
    },
    "remote": {
      "type": "boolean",
      "description": "true = only remote jobs, false = only non-remote jobs. Omit for all."
    },
    "q": {
      "type": "string",
      "maxLength": 100,
      "description": "Text that must appear in the job title, e.g. engineer."
    },
    "location": {
      "type": "string",
      "maxLength": 100,
      "description": "Text that must appear in the location, e.g. London."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Jobs per page (1-500). Default 25."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000,
      "description": "Jobs to skip; use next_offset from the previous result."
    }
  },
  "required": [
    "ats",
    "company"
  ],
  "additionalProperties": false
}

Use when the user asks about one mobile app's store listing - rating, ratings count, installs, price, latest version or release notes - e.g. "what is Spotify's Google Play rating?". id = App Store numeric id (324684580), Android package name (com.spotify.music) or the store URL; the store is inferred. Returns title, developer, rating, star histogram, ratings count, price, installs (Google Play), version, release notes, dates, genre and description. For what users say, use list_app_reviews.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "description": "App Store id (e.g. 324684580), package name (e.g. com.spotify.music) or store URL.",
      "examples": [
        "com.spotify.music",
        "324684580"
      ]
    },
    "store": {
      "type": "string",
      "enum": [
        "apple",
        "google"
      ],
      "description": "Optional; inferred from id (numeric = apple, package name = google)."
    },
    "country": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter store country, default us."
    },
    "lang": {
      "type": "string",
      "description": "Google Play language, e.g. en, de, pt-BR. Default en."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Use when the user wants what people say about an app - complaints, bugs, feature requests, competitor research - e.g. "recent 1- and 2-star reviews of WhatsApp in the UK App Store". Returns the reviews shown on the store page (about 10 per App Store country, 20 per Google Play language) with rating, title, text, date, app version, thumbs-up and developer reply (Google Play). Filter with rating=[1,2], sort and country; page with offset. For ratings and metadata use get_app.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "description": "App Store id, package name or store URL."
    },
    "store": {
      "type": "string",
      "enum": [
        "apple",
        "google"
      ],
      "description": "Optional; inferred from id."
    },
    "country": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter store country, default us."
    },
    "lang": {
      "type": "string",
      "description": "Google Play language, default en."
    },
    "rating": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 5
      },
      "maxItems": 5,
      "description": "Only these star ratings, e.g. [1,2]."
    },
    "sort": {
      "type": "string",
      "enum": [
        "newest",
        "oldest",
        "rating_asc",
        "rating_desc",
        "relevant"
      ],
      "description": "Default newest."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Reviews per page (1-50). Default 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000,
      "description": "Reviews to skip; use next_offset."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}