che.is API

Edge intelligence API

Get IP, geolocation and bot signals in one API call.

One endpoint for IP, geolocation and bot signals with minimal integration overhead.

Test API now Integration guide

Endpoint

GET /v1/context

Payload

IP, country, city, ASN, timezone, bot score

Security

Optional API key via x-api-key

Quick Start

Use SDK or call the endpoint directly

SDK

npm i che.is

import { loadUser, userCountry, userIP } from "che.is";

await loadUser();
console.log(userCountry, userIP);

HTTP API

curl -X GET "https://api.che.is/v1/context" \
  -H "accept: application/json"

Response

Main fields

Field Type Example
ip string | null 203.0.113.10
country string | null US
city string | null Miami
timezone string | null America/New_York
isBot boolean | null false
botScore number | null 95

Playground

Run requests right from the landing page

idle - ms 
Run a request to see response details.

Deployment

Static landing, API-first workflow

npm install
npm run dev
npm run deploy

No backend views needed. The landing ships from public/ and calls the API directly.