한 번의 요청으로 구조화된 웹 결과

1. 첫 요청 보내기

q가 유일한 필수 파라미터입니다. 공개 티어는 Authorization 헤더가 필요 없으며 평가와 소량 사용에 적합합니다.

curl "https://tutusoo.com/api/v1/search?q=rust&limit=5"

2. 출처와 콘텐츠를 올바르게 처리

source=local은 TutuSoo 색인에서 오고, source=brave는 로컬 커버리지가 부족할 때의 웹 폴백입니다.

• 반환된 url로 이동하세요. id에서 외부 주소를 도출하지 마세요.
• 비어 있지 않은 id를 가진 로컬 결과에만 /api/v1/content/{id}를 호출하세요.
• 429, 타임아웃, 오프라인 상태, 빈 결과를 무한 재시도 없이 처리하세요.

3. 페이지네이션과 리소스 제한

웹 UI는 페이지당 10개 결과를 사용하고 깊은 페이지네이션을 제한합니다. API는 쿼리 길이, 결과 수, 허용 깊이를 제한해 한 요청이 검색 자원을 독점하지 못하게 합니다.

• 쿼리는 512자로 제한됩니다.
• limit는 최대 100이며 10–20을 권장합니다.
• time_range는 TutuSoo의 크롤/색인 시간으로 필터링하며 페이지 게시일이 아닙니다.
• 429나 503 응답에는 상한이 있는 지수 백오프를 사용해 재시도 폭주를 피하세요.