GIFDB-Öffentliche-API

Durchsuche und rufe GIFs und Sticker über eine stabile JSON-API ab.

Basis-URL https://gifdb.com/api/v1

Authentifizierung

Sende deinen Partner-API-Schlüssel im X-API-Key Header. Der Health-Endpunkt ist ohne Schlüssel verfügbar. Um API-Zugriff anzufragen, GIFDB kontaktieren.

curl -H "X-API-Key: YOUR_KEY" \
  "https://gifdb.com/api/v1/search?q=celebration&type=gif&limit=20"

Nur-Lese-Endpunkte

Endpunkt	Zweck
`GET /health`	API-Verfügbarkeit und Authentifizierungsstatus.
`GET /trending`	Trend-GIFs oder -Sticker.
`GET /home`	Startseite für kombinierte GIFs.
`GET /categories`	Beliebte Schlagwortkategorien.
`GET /keyword/{slug}`	Medien, die zu einem Stichwort gehören.
`GET /search?q={query}`	GIFs oder Sticker durchsuchen.
`GET /item/{slug}`	Ein Medienelement abrufen.

Allgemeine Parameter

type=gif|sticker wählt den Medientyp aus.
limit=1..100 steuert die Seitengröße.
offset=0.. wählt den Ergebnis-Offset aus.
sort=newest|hot wird durch Stichwortlisten unterstützt.

Maschinenlesbare Ressourcen

Fehler und Ratenbegrenzungen

Fehler verwenden JSON mit ok, error, und message Felder. Ein 401 bedeutet, dass der API-Schlüssel fehlt oder ungültig ist; 429 bedeutet, dass das Anfragenlimit überschritten wurde. Details zum Limit werden in den Antwort-Headern zurückgegeben.