Trickregister API

Die Trickregister API ist eine öffentliche, kostenlose JSON-Schnittstelle. Tricks lassen sich per Freitextsuche finden oder direkt über ihre Registernummer abrufen – ohne Schlüssel, ohne Rate-Limit-Hürden.

Basis-URL: https://trickregister.de/api/api.php · CORS: offen · Format: JSON (UTF-8)

Endpunkte

Methode	Parameter	Beschreibung
`GET`	`?q=...`	Freitextsuche – gibt gerankte Ergebnisse zurück
`GET`	`?code=...`	Direktabruf über Registernummer

GET ?q= – Freitextsuche

Parameter	Typ	Standard	Beschreibung
`q`	string	–	Suchphrase (Pflichtfeld)
`limit`	integer	10	Anzahl Ergebnisse (1 – 50)
`only_code`	0 / 1	0	Wenn 1: nur Registernummer des Top-Treffers

Beispielanfrage

GET /api/api.php?q=Brille%20hochschieben&limit=3

Antwort

{
  "query": "Brille hochschieben",
  "best": {
    "code": "7.3.2",
    "title": "Brille hochschieben statt Hand heben",
    "score": 4.23,
    "percent": 84
  },
  "results": [
    { "code": "7.3.2", "title": "Brille hochschieben statt Hand heben", "score": 4.23, "percent": 84 },
    { "code": "8.1.5", "title": "Blickkontakt statt Handzeichen", "score": 0.91, "percent": 61 }
  ],
  "took_ms": 4
}

Nur die Registernummer

GET /api/api.php?q=brille%20hochschieben&only_code=1

→ { "code": "7.3.2" }

GET ?code= – Direktabruf

Gibt den Trick mit exakt dieser Registernummer zurück (HTTP 404, wenn nicht gefunden).

GET /api/api.php?code=17

→ { "code": "17", "title": "Fortbewegung" }

Fehlercodes

HTTP	Body	Ursache
400	`{"error":"missing_query"}`	Parameter `q` fehlt und kein `code` angegeben
404	`{"error":"not_found"}`	Registernummer existiert nicht
500	`{"error":"internal"}`	Interner Serverfehler

Live ausprobieren

Suchbegriff oder Registernummer

Generierte URL

Antwort

–

Codebeispiele

curl

curl -s 'https://trickregister.de/api/api.php?q=Handy+au%C3%9Ferhalb+des+Raums' | jq .

JavaScript

const res = await fetch('/api/api.php?q=' + encodeURIComponent('Brille hochschieben'));
const data = await res.json();
console.log(data.best.code, data.best.title);

Python

import requests
r = requests.get('https://trickregister.de/api/api.php', params={'q': 'Brille hochschieben'})
print(r.json()['best'])

Lizenz & Attribution

Die Inhalte des Trickregisters sind urheberrechtlich geschützt.
Nichtkommerzielle Nutzung ist erlaubt, sofern die Quelle Trickregister.de und die jeweilige Registernummer angegeben werden.
Für kommerzielle Anwendungen ist eine separate Freigabe erforderlich.

OpenAPI / Swagger

Maschinenlesbare Spezifikation: OpenAPI YAML · OpenAPI JSON · Swagger UI · ReDoc