Docs menu

Tes API endpoint

Get a Tes teaching job API

Returns detail for one job posting by its numeric id (the id field returned by tes-job-search): employer, location, salary, contract terms/types, dates, and application contact/URL, plus a short excerpt of the listing description rather than the full long-form HTML copy.

GETapiKey1 credit/requestTestes.jobDetailResponseDoc/tes/jobs/detail

Endpoint facts

Method: GET
API path: /tes/jobs/detail
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Tes
Response schema: #/definitions/tes.jobDetailResponseDoc

Tes API Try Get a Tes teaching job API in Playground Tes API documentation

How this endpoint behaves

Query parameters:

id (required): a numeric Tes job id, e.g. 2340998.

Notable response behavior:

An unknown or no-longer-listed job id returns 404.
description_excerpt is plain text with HTML tags stripped and truncated to roughly 600 characters, not the full listing copy.
employer_url's trailing numeric id (e.g. 1039424 in .../jobs/employer/epsom-college-1039424) is the id tes-job-employer accepts.
employer_logo_url and employer_header_url are empty when the employer hasn't uploaded that image.

Live monitoring

Monitored request: GET /tes/jobs/detail?id=2340998
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.29 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tes/jobs/detail?id=2340998
Fields returned with a value: 18

Field	In the sample	Value in the sample
id	Has a value
title	Has a value	“Minibus Driver”
url	Has a value	tes.com
employer	Has a value	“Epsom College”
employer_url	Has a value	tes.com
employer_website	Has a value	epsomcollege.org.uk
employer_logo_url	Has a value	l.imgt.es
employer_header_url	Has a value	l.imgt.es
location	Has a value	“Surrey”
salary	Has a value	“£11,956 per year”
contract_terms	Has a value	1 entry
contract_types	Has a value	1 entry
description_excerpt	Has a value	602 characters
posted_date	Has a value	2026-08-31
closing_date	Has a value	2026-10-08
application_url	Has a value	epsomcollege.org.uk
application_email	Has a value
quick_apply	Has a value	false

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Tes job id	2340998
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tes/jobs/detail?id=2340998" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "2340998",
    "title": "Minibus Driver",
    "url": "https://www.tes.com/jobs/vacancy/minibus-driver-epsom-2340998",
    "employer": "Epsom College",
    "employer_url": "https://www.tes.com/jobs/employer/epsom-college-1039424",
    "employer_website": "http://www.epsomcollege.org.uk",
    "employer_logo_url": "https://l.imgt.es/employer-assets/employers/1039424/brandimages/20181030_1126AM_desktop_1039424_logo.jpg",
    "employer_header_url": "https://l.imgt.es/employer-assets/employers/1039424/brandimages/20160908_1226PM_desktop_1039424_header.jpg",
    "location": "Epsom",
    "salary": "£11,956 per year",
    "contract_terms": [
      "Permanent"
    ],
    "contract_types": [
      "Part Time"
    ],
    "description_excerpt": "Epsom College is an independent co educational day and boarding school with approximately 1100 pupils...",
    "posted_date": "2026-08-31T23:00:00.000Z",
    "closing_date": "2026-09-29T23:00:00.000Z",
    "application_url": "https://www.epsomcollege.org.uk/vacancies/minibus-driver/",
    "application_email": "hr.recruitment@epsomcollege.org.uk",
    "quick_apply": false
  }
}

Request schema

No body schema

Response schema

#/definitions/tes.jobDetailResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tes.JobDetail	No
data.application_email	string	No
data.application_url	string	No
data.closing_date	string	No
data.contract_terms	array	No
data.contract_types	array	No
data.description_excerpt	string	No
data.employer	string	No
data.employer_header_url	string	No
data.employer_logo_url	string	No
data.employer_url	string	No
data.employer_website	string	No
data.id	string	No
data.location	string	No
data.posted_date	string	No
data.quick_apply	boolean	No
data.salary	string	No
data.title	string	No
data.url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tes/jobs/detail?id=2340998" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Tes endpoint docs Tes API Get a Tes jobs employer profile API documentation Search Tes teaching jobs API documentation Get a Tes teaching resource API documentation Search Tes teaching resources API documentation Tes Author Shop API documentation Search the Tes Schools Directory API documentation

Open in Playground Back to group

Docs menu

Tes API endpoint

Get a Tes teaching job API

GETapiKey1 credit/requestTestes.jobDetailResponseDoc/tes/jobs/detail

Endpoint facts

Method: GET
API path: /tes/jobs/detail
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Tes
Response schema: #/definitions/tes.jobDetailResponseDoc

Tes API Try Get a Tes teaching job API in Playground Tes API documentation

How this endpoint behaves

Query parameters:

id (required): a numeric Tes job id, e.g. 2340998.

Notable response behavior:

An unknown or no-longer-listed job id returns 404.
description_excerpt is plain text with HTML tags stripped and truncated to roughly 600 characters, not the full listing copy.
employer_url's trailing numeric id (e.g. 1039424 in .../jobs/employer/epsom-college-1039424) is the id tes-job-employer accepts.
employer_logo_url and employer_header_url are empty when the employer hasn't uploaded that image.

Live monitoring

Monitored request: GET /tes/jobs/detail?id=2340998
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.29 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tes/jobs/detail?id=2340998
Fields returned with a value: 18

Field	In the sample	Value in the sample
id	Has a value
title	Has a value	“Minibus Driver”
url	Has a value	tes.com
employer	Has a value	“Epsom College”
employer_url	Has a value	tes.com
employer_website	Has a value	epsomcollege.org.uk
employer_logo_url	Has a value	l.imgt.es
employer_header_url	Has a value	l.imgt.es
location	Has a value	“Surrey”
salary	Has a value	“£11,956 per year”
contract_terms	Has a value	1 entry
contract_types	Has a value	1 entry
description_excerpt	Has a value	602 characters
posted_date	Has a value	2026-08-31
closing_date	Has a value	2026-10-08
application_url	Has a value	epsomcollege.org.uk
application_email	Has a value
quick_apply	Has a value	false

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Tes job id	2340998
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tes/jobs/detail?id=2340998" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "2340998",
    "title": "Minibus Driver",
    "url": "https://www.tes.com/jobs/vacancy/minibus-driver-epsom-2340998",
    "employer": "Epsom College",
    "employer_url": "https://www.tes.com/jobs/employer/epsom-college-1039424",
    "employer_website": "http://www.epsomcollege.org.uk",
    "employer_logo_url": "https://l.imgt.es/employer-assets/employers/1039424/brandimages/20181030_1126AM_desktop_1039424_logo.jpg",
    "employer_header_url": "https://l.imgt.es/employer-assets/employers/1039424/brandimages/20160908_1226PM_desktop_1039424_header.jpg",
    "location": "Epsom",
    "salary": "£11,956 per year",
    "contract_terms": [
      "Permanent"
    ],
    "contract_types": [
      "Part Time"
    ],
    "description_excerpt": "Epsom College is an independent co educational day and boarding school with approximately 1100 pupils...",
    "posted_date": "2026-08-31T23:00:00.000Z",
    "closing_date": "2026-09-29T23:00:00.000Z",
    "application_url": "https://www.epsomcollege.org.uk/vacancies/minibus-driver/",
    "application_email": "hr.recruitment@epsomcollege.org.uk",
    "quick_apply": false
  }
}

Request schema

No body schema

Response schema

#/definitions/tes.jobDetailResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tes.JobDetail	No
data.application_email	string	No
data.application_url	string	No
data.closing_date	string	No
data.contract_terms	array	No
data.contract_types	array	No
data.description_excerpt	string	No
data.employer	string	No
data.employer_header_url	string	No
data.employer_logo_url	string	No
data.employer_url	string	No
data.employer_website	string	No
data.id	string	No
data.location	string	No
data.posted_date	string	No
data.quick_apply	boolean	No
data.salary	string	No
data.title	string	No
data.url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tes/jobs/detail?id=2340998" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Get a Tes teaching job API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Get a Tes teaching job API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related