본문으로 건너뛰기

개발자용

공개 API

도구 등록 정보를 프로그램으로 관리하세요. 쓰기 엔드포인트는 IP당 60요청/분으로 제한됩니다.

AI 에이전트용 읽기 API

공개·익명·읽기 전용 API입니다. 사이트에 공개된 도구를 안정적인 JSON으로 제공하며, IP당 60초에 120회 요청으로 제한됩니다.

API 키나 Bearer 토큰이 필요하지 않습니다. 공개 키를 여기에 보내지 마세요.

  • GET https://www.getsitools.com/api/public/tools공개 도구 목록·검색. 페이지 이동, 정렬, 카테고리·태그 필터를 지원합니다.
  • GET https://www.getsitools.com/api/public/tools/{slug}slug로 도구 1개 조회. 스크린샷, 지원 언어, 로케일 제공 범위를 포함합니다.
  • GET https://www.getsitools.com/api/public/categories지정 로케일의 카테고리 트리와 공개 도구 수를 가져옵니다.

예시

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — OpenAPI 3.1 정의
  • llms.txt — llms.txt - AI 에이전트용 사이트 요약
  • llms-full.txt — llms-full.txt - 공개 도구 전체와 한 줄 요약

인증

모든 요청에 게시 키를 Bearer 토큰으로 담아 보내세요. 키는 서버에 보관하고 클라이언트 코드에 노출하면 안 됩니다.

Authorization: Bearer <PUBLISH_API_KEY>

서버에 PUBLISH_API_KEY를 설정하세요. 설정하지 않으면 API가 인증 없는 쓰기를 받지 않고 503을 반환합니다.

요청 한도

한도는 IP 주소와 경로 범위별로 적용됩니다. 읽기와 쓰기는 버킷이 분리되어 있어 읽기를 많이 해도 쓰기 한도가 줄지 않습니다.

읽기 엔드포인트: 120 / 60s
쓰기 엔드포인트: 60 / 60s

모든 응답에 RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset이 포함됩니다. 429 응답에는 Retry-After도 포함됩니다.

엔드포인트

아래 예시는 $PUBLISH_API_KEY를 사용합니다. 도구 ID 자리에는 생성 엔드포인트가 반환한 ID를 넣으세요.

POST/api/v1/tools/submit-url

URL 제출

URL만 제출하면 수집 시스템이 사이트 정보를 가져와 번역하고 공개합니다. 무료 심사로 별도 수동 작업이 필요 없습니다.

HTTP/HTTPS URL만 지원합니다. 대기열 응답은 URL이 수집 대기열에 접수되었음을 의미합니다.

요청

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

응답

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

오류 응답

오류는 안정적인 오류 코드와 사람이 읽을 수 있는 메시지가 담긴 JSON으로 반환됩니다.

상태 코드코드의미
400VALIDATION_ERROR요청 본문 또는 쿼리 파라미터가 올바르지 않습니다.
401UNAUTHORIZEDBearer 토큰이 없거나 올바르지 않습니다.
404NOT_FOUND요청한 도구가 존재하지 않습니다.
422LOCALES_INCOMPLETE필수 로케일 항목이 빠져 도구를 게시할 수 없습니다.
429RATE_LIMITED요청 한도를 넘었습니다. Retry-After 시간(약 60초) 뒤에 다시 시도하세요.
503API_KEY_NOT_CONFIGURED서버에 PUBLISH_API_KEY가 설정되지 않아 쓰기가 비활성화되어 있습니다.