Developer Docs

Quickstart Guide

The Axiom AI API delivers verified, structured answers to natural language questions in milliseconds. One endpoint. One parameter. Instant truth.

Base URL

axiomai.nanocorp.app

Protocol

HTTPS only

Format

JSON

1

Query the API

Send a GET request with your question as the q parameter.

GEThttps://axiomai.nanocorp.app/api/query
ParameterTypeRequiredDescription
qstringrequiredThe natural language question to look up. URL-encoded.
2

Sample Request

Copy and paste this into your terminal to make your first query.

terminal
$ curl "https://axiomai.nanocorp.app/api/query?q=What+is+the+capital+of+France"

Works with any HTTP client — fetch, axios, requests, curl, wget, or your favorite SDK.

JavaScript
const res = await fetch(
  "https://axiomai.nanocorp.app/api/query?q=" +
  encodeURIComponent("What is the capital of France?")
);
const data = await res.json();
Python
import requests, urllib.parse

q = urllib.parse.quote("What is the capital of France?")
res = requests.get(f"https://axiomai.nanocorp.app/api/query?q={q}")
data = res.json()
3

Sample Response

A successful query returns a structured JSON object with the answer and metadata.

response.json
{
  "found": true,
  "query": "What is the capital of France",
  "question": "What is the capital of France?",
  "answer_short": "Paris",
  "answer_detailed": "Paris is the capital and largest city of France, located in north-central France on the river Seine.",
  "domain": "geography",
  "confidence_score": 0.99,
  "verified": true,
  "source_url": "https://example.com/geography/france",
  "match_strategy": "exact"
}
Response Fields
foundbooleanWhether a matching entry was found in the knowledge base.
querystringThe raw query string you submitted.
answer_shortstringConcise answer — ideal for AI agent consumption.
answer_detailedstringFull answer with context and elaboration.
confidence_scorenumberMatch confidence from 0.0 to 1.0.
verifiedbooleanWhether the answer has been manually verified.
match_strategystringHow the match was found: exact, ilike, or fts.
404No match found
{
  "found": false,
  "query": "your query here",
  "message": "No knowledge entry matched the supplied question."
}
4

Free Tier

Get started immediately — no credit card, no waitlist.

Free Tier — Always Available

No credit card required. No time limit.

100

queries / day

Resets at midnight UTC

< 50ms

response time

p50 latency, globally

0

rate limits

Up to your daily quota

Free

forever

No trial period

Need more? Paid plans start at $29/mo for 10,000 queries/day. See pricing for details.

5

Get Started

Request your free API key — no credit card required. We'll get back to you within 24 hours with your key and rate limit details.

Or email us directly at api@axiomai.ai