Make real queries against https://kendr.org.

Curl request with an API key

curl https://kendr.org/api/v1/query \
  -X POST \
  -H "Authorization: Bearer $KENDR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "surface": "google_search",
    "query": "best llm observability tools",
    "params": {
      "gl": "us",
      "hl": "en",
      "page": 1
    }
  }'

Python requests example against the same endpoint

import os
import requests

response = requests.post(
    'https://kendr.org/api/v1/query',
    headers={
        'Authorization': f"Bearer {os.environ['KENDR_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'surface': 'google_search',
        'query': 'best llm observability tools',
        'params': {'gl': 'us', 'hl': 'en', 'page': 1},
    },
    timeout=30,
)

payload = response.json()
print(payload['data'])
print(payload['remaining_credits'])

.NET HttpClient example

using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("KENDR_API_KEY"));

var body = new
{
    surface = "google_search",
    query = "best llm observability tools",
    @params = new
    {
        gl = "us",
        hl = "en",
        page = 1
    }
};

using var response = await client.PostAsync(
    "https://kendr.org/api/v1/query",
    new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
);

response.EnsureSuccessStatusCode();

using var stream = await response.Content.ReadAsStreamAsync();
var payload = await JsonSerializer.DeserializeAsync(stream);

Console.WriteLine(payload.GetProperty("data").ToString());
Console.WriteLine(payload.GetProperty("remaining_credits").GetInt32());

Java HttpClient example

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

String requestBody = """
{
  "surface": "google_search",
  "query": "best llm observability tools",
  "params": {
    "gl": "us",
    "hl": "en",
    "page": 1
  }
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://kendr.org/api/v1/query"))
    .header("Authorization", "Bearer " + System.getenv("KENDR_API_KEY"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
    .build();

HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Go net/http example

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    body := map[string]any{
        "surface": "google_search",
        "query": "best llm observability tools",
        "params": map[string]any{
            "gl": "us",
            "hl": "en",
            "page": 1,
        },
    }

    rawBody, err := json.Marshal(body)
    if err != nil {
        panic(err)
    }

    req, err := http.NewRequest(http.MethodPost, "https://kendr.org/api/v1/query", bytes.NewReader(rawBody))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer "+os.Getenv("KENDR_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload map[string]any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Println(payload["data"])
    fmt.Println(payload["remaining_credits"])
}