Skip to content

Developers

Public API

Manage tool listings programmatically. Write endpoints are limited to 60 requests per minute per IP.

Read API for AI agents

Public, anonymous and read-only. These endpoints return the same published tools shown on the site as stable JSON, limited to 120 requests per 60s per IP.

No API key or Bearer token is required. Never send the publish key here.

  • GET https://www.getsitools.com/api/public/toolsList or search published tools, with paging, sorting and category or tag filters.
  • GET https://www.getsitools.com/api/public/tools/{slug}One tool by slug, including screenshots, supported languages and locale coverage.
  • GET https://www.getsitools.com/api/public/categoriesThe category tree for a locale, with published tool counts.

Example

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — OpenAPI 3.1 description
  • llms.txt — llms.txt - the site summary for AI agents
  • llms-full.txt — llms-full.txt - every published tool with a one-line summary

Authentication

Only write endpoints require authentication. Public read-only API needs no API key.

Authorization: Bearer <PUBLISH_API_KEY>

Set PUBLISH_API_KEY on the server. When it is not configured the API returns 503 instead of accepting unauthenticated writes.

Rate limits

Limits are applied per IP address and per route scope. Read and write endpoints use separate buckets, so heavy reads cannot exhaust the write allowance.

Read endpoints: 120 / 60s
Write endpoints: 60 / 60s

Every response includes RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. A 429 response also includes Retry-After.

Endpoints

The following examples use PUBLISH_API_KEY. Replace the tool ID placeholder with the ID returned from the submit endpoint.

POST/api/v1/tools/submit-url

Submit URL

Submit just a URL. The collector will automatically scrape website metadata, translate, and publish. Free review with no manual intervention required.

Only HTTP/HTTPS URLs for core AI tools are supported. aiOnlyConfirmed must be true. A queued response means the URL was accepted into the collector queue.

Request

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
  }'

Response

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

Error responses

Errors are returned as JSON with a stable error code and a human-readable message.

StatusCodeMeaning
400VALIDATION_ERRORThe request body or query parameters are invalid.
401UNAUTHORIZEDThe Bearer token is missing or incorrect.
404NOT_FOUNDThe requested tool does not exist.
422LOCALES_INCOMPLETERequired locale fields are missing, so the tool cannot be published.
429RATE_LIMITEDThe rate limit was exceeded. Retry after the Retry-After window (about 60s).
503API_KEY_NOT_CONFIGUREDThe server has no PUBLISH_API_KEY configured, so writes are disabled.