Directory data access
This is a read-only public directory, accessible without JavaScript, accounts or API keys. Cite the canonical profile URL, not an export URL. Search engines can also read the full ordinary website.
Formats
JSON requests
GET /directory-data/v1/teachers?page=1&limit=50 GET /directory-data/v1/teachers?speciality=ielts&q=exam
Parameters: page (positive integer, default 1), limit (1–100, default 50), q (at most 160 characters), speciality (existing speciality slug). Unknown/repeated parameters are rejected. Follow the next URL until null. Errors: 400 invalid query, 404 out-of-range page or missing profile, 429 rate limit (Retry-After), 503 unavailable (Retry-After). Empty matches return 200 with an empty teachers array on page 1.
Fields and meaning
The response contains version, canonicalOrigin (null before a domain is configured), page, limit, total, pages, next and teachers. Each teacher has id (stable teacher:slug), name, url, markdownUrl, description (teacher-supplied copy, translated where applicable), specialities (display names), contactLinks, publicEmail (only explicitly authorised), featured, location, availability, pricing, contentUpdatedAt and sourceVerifiedAt.
Unknown structured facts and dates are null. Legacy dates are not backfilled. Content modification is not a source-verification date; the time of this request is neither. Original import provenance remains stored privately for maintenance. Teacher-supplied claims have not been independently checked.
Search and featured placement
JSON search returns only text/speciality matches. Featured profiles sort first within those matches; featured is not a rating. The visual homepage may also pin a featured teacher outside the current search. Do not infer a location, qualification, price or availability from inclusion.
Responsible access
Cache responses for 60 seconds and use ETag/If-None-Match for conditional requests. At most 600 requests per minute per connection address per server instance; this is a protective burst limit, not a guaranteed quota. Do not send parallel full-directory crawls. Only GET/HEAD are supported. Alternate exports are noindex to avoid competing with canonical profiles. No separate licence to republish teacher copy or photos is granted by this endpoint.