Java SDK

cheap.serp:serpcheap 는 공식 Java 클라이언트입니다 — Java 11 이상(JSON에는 Jackson 사용).

설치

<dependency>
  <groupId>cheap.serp</groupId>
  <artifactId>serpcheap</artifactId>
  <version>0.1.0</version>
</dependency>

빠른 시작

import cheap.serp.serpcheap.*;

SerpCheap client = new SerpCheap("YOUR_API_KEY");
SearchResponse res = client.search(SearchParams.of("best running shoes"));

for (OrganicResult r : res.organic) {
  System.out.println(r.position + ". " + r.title + " — " + r.link);
}

매개변수 및 옵션

SearchParams params = SearchParams.builder()
    .q("best running shoes")
    .gl("us")      // country (default "us")
    .hl("en")      // UI language (optional)
    .tbs("qdr:w")  // time filter (optional)
    .page(1)       // 1-indexed (default 1)
    .build();

SerpCheap client = new SerpCheap("YOUR_API_KEY", ClientOptions.builder()
    .baseUrl("https://api.serp.cheap")
    .timeout(java.time.Duration.ofSeconds(15))
    .maxRetries(2)
    .build());

오류 처리

try {
  SearchResponse res = client.search(SearchParams.of("coffee"));
} catch (SerpCheapException e) {
  System.err.println(e.getCode() + ": " + e.getMessage());
  if (e.isRetryable()) {
    // transient — safe to try again later
  }
}