---
title: "Search language schools (GET)"
method: GET
path: "/school-finder/search"
tags: ["schools"]
---

# Search language schools (GET)

`GET /school-finder/search`

## Request

- Base URL: `https://www.extralingo.com/api/v1`
- URL: `https://www.extralingo.com/api/v1/school-finder/search`
- Auth: none declared

Same search as POST. Agents may GET. Limit is capped at 20. Each hit includes `school_id` (Craft id) for later calls. Prices are indicative.

## Query parameters

- `query` string
- `language` string
- `country` string
- `cities` string
- `limit` integer

## Parameters

- `#/components/parameters/Locale` (unresolved $ref)

## Response `200`

Ranked search results

- SchoolSearchResponse
  - `success` boolean
  - `data` object
    - `hits` object[]: Ranked schools. Each hit includes school_id, title, location, Extralingo URL, and indicative pricing. Prices are not a booking quote.
    - `totalHits` integer
    - `query` string
    - `facetDistribution` object

---

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