torial Logo
Anmelden

Torial API

torial.com is a curated registry of verified freelance journalists in the German-speaking world (DACH). Every profile passed human editorial review at registration. This read-only API exposes exactly the data that is already publicly visible on torial profile pages – never email addresses or private contact data.

Endpoints

The API is versioned under /api/v1/. A machine-readable description is available as an OpenAPI spec.

GET /api/v1/profiles

Paginated search over verified public profiles.

  • topic – IPTC topic slug, e.g. politik
  • region – city, case-insensitive, e.g. Berlin
  • q – full-text search over name and city
  • page – page number, starting at 1
  • page_size – results per page, default 25, max 50

Example: /api/v1/profiles?topic=politik&region=Berlin&page=1

GET /api/v1/profiles/{slug}

Full public profile document: name, topics, region, bio, public links, published content links, and a verification block (status, since, method). Requesting a profile page such as https://www.torial.com/{slug} with Accept: application/json redirects here.

GET /api/v1/meta

Dataset description: profile count, last-updated timestamp, available filters, terms of use, and contact.

Rate limits & access

No authentication is required for read access. Requests are rate-limited per IP (currently 60 requests per minute); exceeding the limit returns 429 with a Retry-After header. API keys with higher limits may be introduced later without breaking unauthenticated clients. For higher rate limits or commercial use, contact us.

Terms of use

  • Contact journalists via the contact form on their torial profile page – never via scraped or inferred contact data.
  • No scraping of private data. The API only serves public profile data.
  • Journalists can opt out of machine-readable distribution at any time; opted-out profiles disappear from this API, the MCP results, and the directory JSON-LD (allow up to a minute for caches). Their human-facing profile pages and Atom feeds remain online. Consumers must not retain data of profiles that are no longer returned.
  • Free for low-volume, read-only use.