> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letsfind.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Open jobs per filter value

> For each filter, its 50 most common values among open jobs that match the other given filters.



## OpenAPI

````yaml /openapi.json get /v1/facets
openapi: 3.1.0
info:
  title: LetsFindWork API
  version: '1'
servers:
  - url: https://api.letsfind.work
security:
  - bearer: []
paths:
  /v1/facets:
    get:
      summary: Open jobs per filter value
      description: >-
        For each filter, its 50 most common values among open jobs that match
        the other given filters.
      operationId: get_Facets
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title, company or department: any part of a
              word, any case. Every word must match.
          required: false
          description: >-
            Words to find in the title, company or department: any part of a
            word, any case. Every word must match.
          name: q
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title, company or department: any part of a
              word, any case. Every word must match.
          required: false
          description: >-
            Words to find in the title, company or department: any part of a
            word, any case. Every word must match.
          name: excludeQ
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title: any part of a word, any case. Every
              word must match.
          required: false
          description: >-
            Words to find in the title: any part of a word, any case. Every word
            must match.
          name: title
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title: any part of a word, any case. Every
              word must match.
          required: false
          description: >-
            Words to find in the title: any part of a word, any case. Every word
            must match.
          name: excludeTitle
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the department: any part of a word, any case.
              Every word must match.
          required: false
          description: >-
            Words to find in the department: any part of a word, any case. Every
            word must match.
          name: department
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the department: any part of a word, any case.
              Every word must match.
          required: false
          description: >-
            Words to find in the department: any part of a word, any case. Every
            word must match.
          name: excludeDepartment
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Whole words to find in the job text, any case, any language. Every
              word must match.
          required: false
          description: >-
            Whole words to find in the job text, any case, any language. Every
            word must match.
          name: text
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Whole words to find in the job text, any case, any language. Every
              word must match.
          required: false
          description: >-
            Whole words to find in the job text, any case, any language. Every
            word must match.
          name: excludeText
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Company name, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Company name, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: company
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Company name, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Company name, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: excludeCompany
          in: query
        - schema:
            type: boolean
            description: >-
              true: only jobs of staffing and recruiting firms; false: none of
              them. Firms are known by name (a list of large firms and the words
              such firms put in their names).
          required: false
          description: >-
            true: only jobs of staffing and recruiting firms; false: none of
            them. Firms are known by name (a list of large firms and the words
            such firms put in their names).
          name: agency
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Applicant tracking system, any case. Repeat the param to match any
              of several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Applicant tracking system, any case. Repeat the param to match any
            of several values; GET /v1/facets lists the values in use.
          name: ats
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Applicant tracking system, any case. Repeat the param to match any
              of several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Applicant tracking system, any case. Repeat the param to match any
            of several values; GET /v1/facets lists the values in use.
          name: excludeAts
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Workplace type, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Workplace type, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: workplaceType
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Employment type, any case. Repeat the param to match any of
              several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Employment type, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: employmentType
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Language of the job text (ISO 639-1), any case. Repeat the param
              to match any of several values; GET /v1/facets lists the values in
              use.
          required: false
          description: >-
            Language of the job text (ISO 639-1), any case. Repeat the param to
            match any of several values; GET /v1/facets lists the values in use.
          name: language
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 20
            description: >-
              A place in any common form: a city ("Munich", "München, DE"), a
              region in any language or its ISO 3166-2 code ("Bavaria",
              "Bayern", "DE-BY"), a country or its code ("Germany", "DE"), a
              group of countries ("Europe", "EU"). "Remote" or "Remote in
              Germany" keep remote jobs only. Repeat the param to match any of
              several places.
          required: false
          description: >-
            A place in any common form: a city ("Munich", "München, DE"), a
            region in any language or its ISO 3166-2 code ("Bavaria", "Bayern",
            "DE-BY"), a country or its code ("Germany", "DE"), a group of
            countries ("Europe", "EU"). "Remote" or "Remote in Germany" keep
            remote jobs only. Repeat the param to match any of several places.
          name: location
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 20
            description: >-
              A place in any common form: a city ("Munich", "München, DE"), a
              region in any language or its ISO 3166-2 code ("Bavaria",
              "Bayern", "DE-BY"), a country or its code ("Germany", "DE"), a
              group of countries ("Europe", "EU"). "Remote" or "Remote in
              Germany" keep remote jobs only. Repeat the param to match any of
              several places.
          required: false
          description: >-
            A place in any common form: a city ("Munich", "München, DE"), a
            region in any language or its ISO 3166-2 code ("Bavaria", "Bayern",
            "DE-BY"), a country or its code ("Germany", "DE"), a group of
            countries ("Europe", "EU"). "Remote" or "Remote in Germany" keep
            remote jobs only. Repeat the param to match any of several places.
          name: excludeLocation
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Country (ISO 3166-1 alpha-2, any case); a job in several places
              matches any. Repeat the param to match any of several values; GET
              /v1/facets lists the values in use.
          required: false
          description: >-
            Country (ISO 3166-1 alpha-2, any case); a job in several places
            matches any. Repeat the param to match any of several values; GET
            /v1/facets lists the values in use.
          name: country
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Region or state, as GET /v1/facets lists it, or its ISO 3166-2
              code ("DE-BY"). Repeat the param to match any of several values;
              GET /v1/facets lists the values in use.
          required: false
          description: >-
            Region or state, as GET /v1/facets lists it, or its ISO 3166-2 code
            ("DE-BY"). Repeat the param to match any of several values; GET
            /v1/facets lists the values in use.
          name: region
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              City, as GET /v1/facets lists it. Repeat the param to match any of
              several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            City, as GET /v1/facets lists it. Repeat the param to match any of
            several values; GET /v1/facets lists the values in use.
          name: city
          in: query
        - schema:
            type: array
            items:
              type: string
              pattern: ^\d{1,4}$
            minItems: 1
            maxItems: 50
            description: >-
              ISCO-08 occupation code or group prefix ("25" holds "2512").
              Repeat to match any.
          required: false
          description: >-
            ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat
            to match any.
          name: occupation
          in: query
        - schema:
            type: array
            items:
              type: string
              pattern: ^\d{1,4}$
            minItems: 1
            maxItems: 50
            description: >-
              ISCO-08 occupation code or group prefix ("25" holds "2512").
              Repeat to match any.
          required: false
          description: >-
            ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat
            to match any.
          name: excludeOccupation
          in: query
        - schema:
            type:
              - integer
              - 'null'
            minimum: 0
            maximum: 10000000
            description: >-
              Yearly pay at least this, in EUR (the middle of the employer's
              range, converted at the day's rate). Jobs without pay are left
              out.
          required: false
          description: >-
            Yearly pay at least this, in EUR (the middle of the employer's
            range, converted at the day's rate). Jobs without pay are left out.
          name: salaryMinEur
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Industry of the company, as Wikidata names it ("software
              industry"); jobs of companies with no known industry are left out.
              Repeat the param to match any of several values; GET /v1/facets
              lists the values in use.
          required: false
          description: >-
            Industry of the company, as Wikidata names it ("software industry");
            jobs of companies with no known industry are left out. Repeat the
            param to match any of several values; GET /v1/facets lists the
            values in use.
          name: industry
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - 1-10
                - 11-50
                - 51-200
                - 201-500
                - 501-1000
                - 1001-5000
                - 5001-10000
                - 10001+
            minItems: 1
            maxItems: 8
            description: >-
              Headcount band of the company. Repeat to match any; jobs of
              companies with no known headcount are left out.
          required: false
          description: >-
            Headcount band of the company. Repeat to match any; jobs of
            companies with no known headcount are left out.
          name: companySize
          in: query
        - schema:
            type: boolean
            description: >-
              true: one job per duplicate group (the first posted) and every job
              without duplicates; false: only the other jobs of each group.
              Without it, all jobs. A group is the same company, title and
              places on two or more boards, posted within 30 days.
          required: false
          description: >-
            true: one job per duplicate group (the first posted) and every job
            without duplicates; false: only the other jobs of each group.
            Without it, all jobs. A group is the same company, title and places
            on two or more boards, posted within 30 days.
          name: canonical
          in: query
        - schema:
            anyOf:
              - type: string
                format: date-time
              - type: string
                format: date
            description: >-
              Jobs posted (or first seen, when earlier or undated) at or after
              this date or time, UTC
          required: false
          description: >-
            Jobs posted (or first seen, when earlier or undated) at or after
            this date or time, UTC
          name: postedAfter
          in: query
        - schema:
            type: array
            items:
              type: integer
              exclusiveMinimum: 0
              maximum: 2147483647
            minItems: 1
            maxItems: 100
            description: Job ids. Repeat the param to match any, up to 100.
          required: false
          description: Job ids. Repeat the param to match any, up to 100.
          name: ids
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 2000
            minItems: 1
            maxItems: 10
            description: >-
              The job's URL on its board or its application form URL, exactly as
              the job has it. Repeat the param to match any, up to 10.
          required: false
          description: >-
            The job's URL on its board or its application form URL, exactly as
            the job has it. Repeat the param to match any, up to 10.
          name: url
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - health
                - retirement
                - paid_time_off
                - wellness
            minItems: 1
            maxItems: 4
            description: >-
              Benefit the job text offers, read by rules: health, retirement,
              paid_time_off, wellness. Repeat the param to match any.
          required: false
          description: >-
            Benefit the job text offers, read by rules: health, retirement,
            paid_time_off, wellness. Repeat the param to match any.
          name: benefit
          in: query
        - schema:
            type: boolean
            description: >-
              Read by rules from the job text. true: jobs that say they sponsor
              visas; false: jobs that say they do not, or that need the right to
              work already. Jobs whose text says nothing are left out.
          required: false
          description: >-
            Read by rules from the job text. true: jobs that say they sponsor
            visas; false: jobs that say they do not, or that need the right to
            work already. Jobs whose text says nothing are left out.
          name: visaSponsorship
          in: query
      responses:
        '200':
          description: Counts per value
          content:
            application/json:
              schema:
                type: object
                properties:
                  facets:
                    type: object
                    properties:
                      company:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      ats:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      workplaceType:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      employmentType:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      language:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      country:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      region:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      city:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      occupation:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      industry:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      companySize:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      benefit:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                      visaSponsorship:
                        type: array
                        items:
                          type: object
                          properties:
                            value:
                              type: string
                            count:
                              type: integer
                          required:
                            - value
                            - count
                    required:
                      - company
                      - ats
                      - workplaceType
                      - employmentType
                      - language
                      - country
                      - region
                      - city
                      - occupation
                      - industry
                      - companySize
                      - benefit
                      - visaSponsorship
                required:
                  - facets
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.