jobs

Search jobs

Search the Litos job board: verified postings across many roles, pulled from several job boards, with an emphasis on the United States. With a resume on file the results are ranked and each job carries match_score (resume fit) and preference_score (fit to saved preferences). Use offset to page. Each job's id is what start_application takes.

post/v1/search_jobs

Request

  • Base URL: https://api.trylitos.com
  • URL: https://api.trylitos.com/v1/search_jobs
  • Auth: OAuth 2 (authorization code, authorization URL https://api.trylitos.com/oauth/authorize, token URL https://api.trylitos.com/oauth/token, scopes: jobs:read)

Request body

qstring

Free-text search over title, company and description

titlestring
companystring
locationstring
remote'true' | 'false'
employment_type'Full-time' | 'Part-time' | 'Internship' | 'Apprenticeship' | 'Contract'
sponsor_only'true' | 'false'

Only employers with a visa sponsorship record

relax_targeting'true' | 'false'

Widen past the saved preferences one at a time (titles, then places to their country, then season, then role type, then field), stopping at the first non-empty board (on a first page with a resume, past a board whose best match is weak); the response lists what was relaxed

strong_only'true' | 'false'

Only strong resume matches

limitinteger
offsetinteger

Response

The operation's result. Shapes mirror the Litos dashboard routes they proxy.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.