---
title: "Search the Tes Schools Directory"
method: GET
path: "/tes/schools/search"
tags: ["Tes"]
---

# Search the Tes Schools Directory

`GET /tes/schools/search`

## Request

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

Searches Tes's (tes.com) public Schools Directory by school name or location. Returns listing facts (name, logo, a short description, address) for each matching school/employer. Each result's id is the same employer id tes-job-employer accepts, so a caller can go straight from a name/location search to a full employer profile (school type/phase/funding status/gender/age range, and its currently-open positions) without first needing a job posting to discover the id.

## Query parameters

- `query` string, required
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TesSchoolSearchResponseDoc
  - `code` integer
  - `data` TesSchoolSearchResponse
    - `page` integer
    - `page_size` integer
    - `query` string
    - `schools` TesSchoolSummary[]
      - `address` string
      - `country` string
      - `description` string
      - `id` string
      - `logo_url` string
      - `name` string
      - `post_code` string
      - `url` string
    - `total` integer
    - `total_pages` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)