Zum Inhalt springen

Für Entwickler

Öffentliche API

Verwalte Werkzeug-Einträge programmatisch. Schreib-Endpoints sind auf 60 Anfragen pro Minute und IP begrenzt.

Lese-API für KI-Agenten

Öffentlich, anonym und schreibgeschützt. Die Endpunkte liefern veröffentlichte Tools als stabiles JSON, begrenzt auf 120 Anfragen pro 60 s und IP.

Kein API-Schlüssel und kein Bearer-Token erforderlich. Sende den Veröffentlichungsschlüssel niemals hierhin.

  • GET https://www.getsitools.com/api/public/toolsVeröffentlichte Tools auflisten oder durchsuchen, mit Seitenwechsel, Sortierung und Filtern nach Kategorie oder Tag.
  • GET https://www.getsitools.com/api/public/tools/{slug}Ein Tool per Slug, inklusive Screenshots, unterstützter Sprachen und Locale-Abdeckung.
  • GET https://www.getsitools.com/api/public/categoriesDer Kategoriebaum für ein Locale mit Anzahl veröffentlichter Tools.

Beispiel

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — OpenAPI-3.1-Definition
  • llms.txt — llms.txt – Website-Zusammenfassung für KI-Agenten
  • llms-full.txt — llms-full.txt – alle veröffentlichten Tools mit Ein-Satz-Zusammenfassung

Authentifizierung

Sende deinen Publish-Schlüssel bei jeder Anfrage als Bearer-Token. Bewahre den Schlüssel auf dem Server auf und lege ihn nie in Client-Code offen.

Authorization: Bearer <PUBLISH_API_KEY>

Setze PUBLISH_API_KEY auf dem Server. Ist er nicht gesetzt, gibt die API 503 zurück statt unauthentifizierte Schreibzugriffe zu akzeptieren.

Ratenlimits

Die Limits gelten pro IP-Adresse und pro Route-Bereich. Lese- und Schreib-Endpoints nutzen getrennte Töpfe, sodass viele Lesezugriffe das Schreib-Kontingent nicht erschöpfen.

Lese-Endpoints: 120 / 60s
Schreib-Endpoints: 60 / 60s

Jede Antwort enthält RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. Eine 429-Antwort enthält zusätzlich Retry-After.

Endpunkte

Die Beispiele unten verwenden $PUBLISH_API_KEY. Ersetze den Platzhalter für die Werkzeug-ID durch die vom Create-Endpoint zurückgegebene ID.

POST/api/v1/tools/submit-url

URL einreichen

Sende nur eine URL. Das Sammelsystem ruft die Website-Daten ab, übersetzt sie und veröffentlicht den Eintrag. Kostenlose Prüfung ohne manuellen Eingriff.

Nur HTTP/HTTPS-URLs werden unterstützt. Eine Warteschlangen-Antwort bedeutet, dass die URL in die Sammelwarteschlange aufgenommen wurde.

Anfrage

curl -X POST 'https://www.getsitools.com/en/api/v1/tools/submit-url' \
  -H 'Authorization: Bearer $PUBLISH_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com",
    "aiOnlyConfirmed": true
  }'

Antwort

{
  "id": "submission_abc123",
  "submissionId": "submission_abc123",
  "status": "queued",
  "duplicate": false,
  "message": "URL submitted successfully. The collector will scrape and process it automatically."
}

Fehlerantworten

Fehler werden als JSON mit stabilem Fehlercode und lesbarer Meldung zurückgegeben.

HTTP-StatusFehlercodeBedeutung
400VALIDATION_ERRORAnfrage-Body oder Query-Parameter sind ungültig.
401UNAUTHORIZEDDas Bearer-Token fehlt oder ist falsch.
404NOT_FOUNDDas angefragte Werkzeug existiert nicht.
422LOCALES_INCOMPLETEPflicht-Sprachfelder fehlen, das Werkzeug kann nicht veröffentlicht werden.
429RATE_LIMITEDRatenlimit überschritten. Nach dem Retry-After-Fenster (ca. 60 s) erneut versuchen.
503API_KEY_NOT_CONFIGUREDAuf dem Server ist kein PUBLISH_API_KEY gesetzt, Schreibzugriffe sind deaktiviert.