Tes

Search Tes teaching jobs

Searches Tes's (tes.com) teaching-jobs board. Returns listing facts (title, employer, location, salary, contract terms/types) plus a short excerpt of the listing description, not the full long-form job-description copy, and the same live faceted-search breakdown (position/subject/workplace category trees with counts, plus contract type/term counts) the real search page renders as its filter sidebar. location is a free-text place name (a UK town/city, an international city, or a bare country name) resolved to coordinates; omit for Tes's own default market, "United Kingdom". radius_miles selects the search radius around location. contract_type and contract_term are validated against Tes's own small, closed label sets. position, subject, and workplace are comma-separated filters -- Tes's own category labels are numerous and can change, so read a prior response's own facets.positions[].value (and facets.positions[].children[].value)/facets.subjects[].value/facets.workplaces[].children[].value for the live, current set rather than guessing. salary_min filters to jobs with an advertised salary at or above that amount (in the searched market's local currency); Tes's own filter panel offers only a minimum, no maximum.

get/tes/jobs/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/tes/jobs/search
  • Auth: API key in header x-api-key

Query parameters

keywordsstring

Job title or keyword

locationstring

Free-text place name resolved via Tes's own location autocomplete

radius_miles3 | 5 | 10 | 15 | 20 | 30 | 50 | 70 | 100 | 500

Search radius around location, in miles

pageinteger

One-based page

page_sizeinteger

Results per page

sort'relevance' | 'newest' | 'distance'

Sort order

contract_type'Full Time' | 'Part Time'

Contract type

contract_term'Permanent' | 'Fixed Term' | 'Casual' | 'Maternity Cover' | 'Temporary' | 'Supply'

Contract term

positionstring

Comma-separated position category label(s) -- see the endpoint markdown

subjectstring

Comma-separated subject label(s) -- see the endpoint markdown

workplacestring

Comma-separated workplace/organisation-type label(s) -- see the endpoint markdown

salary_mininteger

Minimum advertised salary, in the searched market's local currency

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.