> ## Documentation Index > Fetch the complete documentation index at: https://docs.anysite.io/llms.txt > Use this file to discover all available pages before exploring further. # /hh/vacancies/search > Search HeadHunter vacancies by keyword and filters **Price:** 10 credits per 50 results ## OpenAPI ````yaml /openapi/jobs.json post /api/hh/vacancies/search openapi: 3.1.0 info: title: Any Site API description: >+ Any Site API provides programmatic access to data from LinkedIn, Instagram, Twitter, and other platforms. ## Authentication All API endpoints require an `access-token` header with a valid API token. Tokens can be created in the [dashboard](https://app.anysite.io/). ## Pricing Each endpoint has a credit cost listed in its description. Credits are deducted from your token balance per request. version: 0.0.1 servers: [] security: - AccessToken: [] paths: /api/hh/vacancies/search: post: tags: - /hh summary: /hh/vacancies/search description: |- Search HeadHunter vacancies by keyword and filters **Price:** 10 credits per 50 results operationId: __api_hh_vacancies_search_post parameters: - name: access-token in: header required: true schema: anyOf: - type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/HhVacanciesSearchPayload' responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/HhVacancySearchItem' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: HhVacanciesSearchPayload: properties: timeout: type: integer maximum: 1500 minimum: 20 default: 300 text: type: string minLength: 1 count: type: integer maximum: 2000 minimum: 1 search_field: anyOf: - $ref: '#/components/schemas/HhSearchField' - type: 'null' area: anyOf: - type: integer - type: 'null' salary: anyOf: - type: integer minimum: 0 - type: 'null' currency: anyOf: - $ref: '#/components/schemas/HhCurrency' - type: 'null' only_with_salary: anyOf: - type: boolean - type: 'null' professional_role: anyOf: - type: integer - type: 'null' industry: anyOf: - type: integer - type: 'null' education: anyOf: - $ref: '#/components/schemas/HhEducation' - type: 'null' experience: anyOf: - $ref: '#/components/schemas/HhExperience' - type: 'null' employment: anyOf: - $ref: '#/components/schemas/HhEmployment' - type: 'null' schedule: anyOf: - $ref: '#/components/schemas/HhSchedule' - type: 'null' working_hours: anyOf: - $ref: '#/components/schemas/HhWorkingHours' - type: 'null' work_format: anyOf: - $ref: '#/components/schemas/HhWorkFormat' - type: 'null' label: anyOf: - $ref: '#/components/schemas/HhLabel' - type: 'null' order_by: anyOf: - $ref: '#/components/schemas/HhOrderBy' - type: 'null' period: anyOf: - $ref: '#/components/schemas/HhSearchPeriod' - type: 'null' type: object required: - text - count HhVacancySearchItem: properties: '@type': type: string default: HhVacancySearchItem id: type: integer name: type: string url: type: string salary: anyOf: - $ref: '#/components/schemas/HhSalary' - type: 'null' employer: anyOf: - $ref: '#/components/schemas/HhSearchEmployer' - type: 'null' address: anyOf: - $ref: '#/components/schemas/HhVacancyAddress' - type: 'null' area_id: anyOf: - type: integer - type: 'null' area_name: anyOf: - type: string - type: 'null' experience: anyOf: - type: string - type: 'null' employment_form: anyOf: - type: string - type: 'null' work_formats: items: type: string type: array default: [] work_schedule_by_days: items: type: string type: array default: [] working_hours: items: type: string type: array default: [] professional_role_ids: items: type: integer type: array default: [] snippet: anyOf: - $ref: '#/components/schemas/HhVacancySearchSnippet' - type: 'null' response_count: anyOf: - type: integer - type: 'null' is_premium: anyOf: - type: boolean - type: 'null' is_advertisement: anyOf: - type: boolean - type: 'null' accept_temporary: anyOf: - type: boolean - type: 'null' accept_labor_contract: anyOf: - type: boolean - type: 'null' published_at: anyOf: - type: string - type: 'null' created_at: anyOf: - type: string - type: 'null' type: object required: - id - name - url HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object HhSearchField: type: string enum: - name - company_name - description HhCurrency: type: string enum: - RUR - USD - EUR - KZT - UAH - BYR - AZN - GEL - KGS - UZS HhEducation: type: string enum: - not_required_or_not_specified - higher - special_secondary HhExperience: type: string enum: - noExperience - between1And3 - between3And6 - moreThan6 HhEmployment: type: string enum: - full - part - project - flyInFlyOut HhSchedule: type: string enum: - fullDay - shift - flexible - remote - flyInFlyOut HhWorkingHours: type: string enum: - HOURS_2 - HOURS_3 - HOURS_4 - HOURS_5 - HOURS_6 - HOURS_7 - HOURS_8 - HOURS_9 - HOURS_10 - HOURS_11 - HOURS_12 - HOURS_24 HhWorkFormat: type: string enum: - ON_SITE - REMOTE - HYBRID - FIELD_WORK HhLabel: type: string enum: - with_address - not_from_agency - accept_kids - accredited_it - internship - night_shifts - with_salary HhOrderBy: type: string enum: - relevance - publication_time - salary_desc - salary_asc HhSearchPeriod: type: string enum: - '0' - '1' - '3' - '7' HhSalary: properties: '@type': type: string default: HhSalary salary_from: anyOf: - type: integer - type: 'null' salary_to: anyOf: - type: integer - type: 'null' currency: anyOf: - type: string - type: 'null' is_gross: anyOf: - type: boolean - type: 'null' mode: anyOf: - type: string - type: 'null' mode_label: anyOf: - type: string - type: 'null' frequency: anyOf: - type: string - type: 'null' frequency_label: anyOf: - type: string - type: 'null' type: object HhSearchEmployer: properties: '@type': type: string default: HhSearchEmployer id: anyOf: - type: integer - type: 'null' name: anyOf: - type: string - type: 'null' image: anyOf: - type: string - type: 'null' web_url: anyOf: - type: string - type: 'null' is_accredited_it: anyOf: - type: boolean - type: 'null' is_trusted: anyOf: - type: boolean - type: 'null' rating: anyOf: - type: number - type: 'null' review_count: anyOf: - type: integer - type: 'null' type: object HhVacancyAddress: properties: '@type': type: string default: HhVacancyAddress city: anyOf: - type: string - type: 'null' street: anyOf: - type: string - type: 'null' building: anyOf: - type: string - type: 'null' display_name: anyOf: - type: string - type: 'null' district: anyOf: - type: string - type: 'null' lat: anyOf: - type: number - type: 'null' lng: anyOf: - type: number - type: 'null' metro_stations: items: $ref: '#/components/schemas/HhMetroStation' type: array default: [] type: object HhVacancySearchSnippet: properties: '@type': type: string default: HhVacancySearchSnippet requirement: anyOf: - type: string - type: 'null' responsibility: anyOf: - type: string - type: 'null' conditions: anyOf: - type: string - type: 'null' skills: anyOf: - type: string - type: 'null' type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array msg: type: string type: type: string input: {} ctx: type: object type: object required: - loc - msg - type HhMetroStation: properties: '@type': type: string default: HhMetroStation id: anyOf: - type: integer - type: 'null' name: anyOf: - type: string - type: 'null' line_color: anyOf: - type: string - type: 'null' type: object securitySchemes: AccessToken: type: apiKey in: header name: access-token description: API token from the dashboard ````