Quickstart

Find AI-cited sources with Java

Send a query to the Getspotted API from Java and get back the sources AI engines (ChatGPT, Claude, Perplexity, Gemini) and Google cite for it, per country. Authenticate with Authorization: Bearer gsp_live_…

Call the API

HttpRequest req = HttpRequest.newBuilder()
  .uri(URI.create("https://getspotted.ai/api/v1/search"))
  .header("Authorization", "Bearer gsp_live_…")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"query\":\"best CRM for B2B SaaS\",\"country\":\"US\"}"))
  .build();
HttpResponse<String> res = HttpClient.newHttpClient()
  .send(req, HttpResponse.BodyHandlers.ofString());

Each search costs 10 credits. The response shape is { success, data: { sources, hotspots, enginesQueried } } — every source lists the engines that cited it and its per-engine position.

Next steps

Other languages