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.
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.
{
"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-Status
Fehlercode
Bedeutung
400
VALIDATION_ERROR
Anfrage-Body oder Query-Parameter sind ungültig.
401
UNAUTHORIZED
Das Bearer-Token fehlt oder ist falsch.
404
NOT_FOUND
Das angefragte Werkzeug existiert nicht.
422
LOCALES_INCOMPLETE
Pflicht-Sprachfelder fehlen, das Werkzeug kann nicht veröffentlicht werden.
429
RATE_LIMITED
Ratenlimit überschritten. Nach dem Retry-After-Fenster (ca. 60 s) erneut versuchen.
503
API_KEY_NOT_CONFIGURED
Auf dem Server ist kein PUBLISH_API_KEY gesetzt, Schreibzugriffe sind deaktiviert.