Find your role first Jobs API

The Jobs API from Find your role first — 7 operation(s) for jobs.

GitHub OpenAPI

Operations 9

GET /api/jobs Search #
GET /api/jobs/count Count #
GET /api/jobs/count/exact Count Exact #
GET /jobs Live Index #
HEAD /jobs Live Index #
GET /jobs/{slug} Live Category #
HEAD /jobs/{slug} Live Category #
GET /api/jobs/{job_id}/apply-kit Apply Kit For #
GET /api/jobs/{job_id} Detail #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/findyourrolefirst-click:findyourrolefirst-click-jobs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

findyourrolefirst-click-jobs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Find your role first Jobs API
  version: 0.2.0
tags:
- name: Jobs
paths:
  /api/jobs:
    get:
      summary: Search
      operationId: search_api_jobs_get
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 160
          default: ''
          title: Query
      - name: location
        in: query
        required: false
        schema:
          type: string
          maxLength: 100
          default: ''
          title: Location
      - name: source
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - gh
            - ashby
            - lever
            - workday
            - amazon
            - microsoft
            - netflix
            - apple
            - google
            - meta
            - eightfold
            - jibe
            - phenom
            - atlassian
            - successfactors
            - radancy
            type: string
          - type: 'null'
          title: Source
      - name: published_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Published Since
      - name: discovered_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Discovered Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 20
          minimum: 1
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          maximum: 10000
          minimum: 0
          default: 0
          title: Offset
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          maxLength: 120
          default: ''
          title: Exclude
      - name: remote
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Remote
      - name: posted_within_hours
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 1440
            minimum: 1
          - type: 'null'
          title: Posted Within Hours
      - name: experience
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - 0-1
              - 1-3
              - 3-5
              - 5-8
              - 8+
              - not_stated
              - unchecked
              type: string
          - type: 'null'
          title: Experience
      - name: family
        in: query
        required: false
        schema:
          anyOf:
          - const: product_adjacent
            type: string
          - type: 'null'
          title: Family
      - name: roles
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Roles
      - name: locations
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 8
          - type: 'null'
          title: Locations
      - name: badges
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - yc
              - a16z
              - bigtech
              - bank
              - quant
              - consulting
              type: string
            maxItems: 5
          - type: 'null'
          title: Badges
      - name: focus
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 40
            maxItems: 8
          - type: 'null'
          title: Focus
      - name: exact
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Exact
      - name: not_similar
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Not Similar
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
  /api/jobs/count:
    get:
      summary: Count
      description: 'How many roles a search matches. Free: nothing is returned, nothing is charged.

        A count past 1,000 gets two seconds.'
      operationId: count_api_jobs_count_get
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 160
          default: ''
          title: Query
      - name: location
        in: query
        required: false
        schema:
          type: string
          maxLength: 100
          default: ''
          title: Location
      - name: source
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - gh
            - ashby
            - lever
            - workday
            - amazon
            - microsoft
            - netflix
            - apple
            - google
            - meta
            - eightfold
            - jibe
            - phenom
            - atlassian
            - successfactors
            - radancy
            type: string
          - type: 'null'
          title: Source
      - name: published_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Published Since
      - name: discovered_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Discovered Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 20
          minimum: 1
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          maximum: 10000
          minimum: 0
          default: 0
          title: Offset
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          maxLength: 120
          default: ''
          title: Exclude
      - name: remote
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Remote
      - name: posted_within_hours
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 1440
            minimum: 1
          - type: 'null'
          title: Posted Within Hours
      - name: experience
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - 0-1
              - 1-3
              - 3-5
              - 5-8
              - 8+
              - not_stated
              - unchecked
              type: string
          - type: 'null'
          title: Experience
      - name: family
        in: query
        required: false
        schema:
          anyOf:
          - const: product_adjacent
            type: string
          - type: 'null'
          title: Family
      - name: roles
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Roles
      - name: locations
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 8
          - type: 'null'
          title: Locations
      - name: badges
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - yc
              - a16z
              - bigtech
              - bank
              - quant
              - consulting
              type: string
            maxItems: 5
          - type: 'null'
          title: Badges
      - name: focus
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 40
            maxItems: 8
          - type: 'null'
          title: Focus
      - name: exact
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Exact
      - name: not_similar
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Not Similar
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
  /api/jobs/count/exact:
    get:
      summary: Count Exact
      description: 'The console''s count, run once per Search press (not per keystroke), so it can

        take up to 15 s and be exact even for ''United States'' alone.'
      operationId: count_exact_api_jobs_count_exact_get
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 160
          default: ''
          title: Query
      - name: location
        in: query
        required: false
        schema:
          type: string
          maxLength: 100
          default: ''
          title: Location
      - name: source
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - gh
            - ashby
            - lever
            - workday
            - amazon
            - microsoft
            - netflix
            - apple
            - google
            - meta
            - eightfold
            - jibe
            - phenom
            - atlassian
            - successfactors
            - radancy
            type: string
          - type: 'null'
          title: Source
      - name: published_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Published Since
      - name: discovered_since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Discovered Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 20
          minimum: 1
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          maximum: 10000
          minimum: 0
          default: 0
          title: Offset
      - name: exclude
        in: query
        required: false
        schema:
          type: string
          maxLength: 120
          default: ''
          title: Exclude
      - name: remote
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Remote
      - name: posted_within_hours
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 1440
            minimum: 1
          - type: 'null'
          title: Posted Within Hours
      - name: experience
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - 0-1
              - 1-3
              - 3-5
              - 5-8
              - 8+
              - not_stated
              - unchecked
              type: string
          - type: 'null'
          title: Experience
      - name: family
        in: query
        required: false
        schema:
          anyOf:
          - const: product_adjacent
            type: string
          - type: 'null'
          title: Family
      - name: roles
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Roles
      - name: locations
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 8
          - type: 'null'
          title: Locations
      - name: badges
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              enum:
              - yc
              - a16z
              - bigtech
              - bank
              - quant
              - consulting
              type: string
            maxItems: 5
          - type: 'null'
          title: Badges
      - name: focus
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 40
            maxItems: 8
          - type: 'null'
          title: Focus
      - name: exact
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Exact
      - name: not_similar
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
              maxLength: 100
            maxItems: 40
          - type: 'null'
          title: Not Similar
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
  /jobs:
    get:
      summary: Live Index
      operationId: live_index_jobs_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
      tags:
      - Jobs
    head:
      summary: Live Index
      operationId: headJobs
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
      tags:
      - Jobs
      x-operation-id-source: normalized
      x-operation-id-original: live_index_jobs_get
  /jobs/{slug}:
    get:
      summary: Live Category
      operationId: live_category_jobs__slug__get
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
    head:
      summary: Live Category
      operationId: headJobsBySlug
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
      x-operation-id-source: normalized
      x-operation-id-original: live_category_jobs__slug__get
  /api/jobs/{job_id}/apply-kit:
    get:
      summary: Apply Kit For
      description: 'The apply link, the form''s questions when published, and what we know about the role.

        Charged like opening the role; nothing is ever submitted.'
      operationId: apply_kit_for_api_jobs__job_id__apply_kit_get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
  /api/jobs/{job_id}:
    get:
      summary: Detail
      operationId: detail_api_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Jobs
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError