Documentation

Nostimates API

The Nostimates API — the same data behind the dashboard, read-only, for teams that want it in their own systems. Submit prompts, pick surfaces and markets, and read back who was cited and mentioned with a 95% interval on every rate. Everything is collected from the real interfaces — never from provider APIs.

curl -X POST https://api.nostimates.com/v1/runs \
  -H "Authorization: Bearer $NOSTIMATES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "best CRM for B2B sales",
    "surfaces": ["google_ai_overviews", "chatgpt", "perplexity"],
    "country": "US",
    "language": "en",
    "samples": 10,
    "webhook_url": "https://your-app.example.com/hooks/nostimates"
  }'

Base URL https://api.nostimates.com — all endpoints are versioned under /v1.

Getting started

Introduction

What the Nostimates API returns, who it is for, and the two decisions that shape every endpoint.

Quickstart

Create your first tracking run and read a distribution back in under five minutes.

Authentication

Bearer keys, workspaces, and per-client isolation for agencies running many accounts.

Core concepts

Surfaces and locales

The twelve surface identifiers, how country and language work, and where they diverge.

n-sampling and distributions

Why every result is a range, how the interval is calculated, and how to choose n.

API reference

Runs

Create a tracking run, read its status, and fetch parsed results with distributions.

Evidence

Pull the raw AI answers behind any number so a skeptical client can see the receipts.

Webhooks

Receive completed runs and alert events without polling.

Errors and rate limits

Status codes, error shapes, quota behaviour and what to retry.

Operations

Extraction reliability

Canaries, parser versioning, and the honest numbers on extraction success.

White-labelling

Putting our data in your product without our name showing up anywhere.

Changelog

Surface coverage, parser versions and API changes over time.