OrganiKPI AI Search API
Pay per call in USDC on Base with x402. No account, no API key.
Endpoints
| Call | Price | Returns |
|---|---|---|
GET /v1/audit?url= | $0.03 | AI-readiness score from 0 to 100 for one page, with each check |
POST /v1/citations | $0.10 | Job id for one prompt run on ChatGPT, Google AI Mode and Gemini |
GET /v1/citations/{id} | free | Each engine's answer, cited URLs, top cited domains, brand and domain matches |
POST /v1/citations/{id}/retry | free | Re-runs failed engines, once each |
Paying with x402
- Send the request with no payment. The response is HTTP 402 with a
PAYMENT-REQUIREDheader listing price, asset, network and recipient. - Sign the USDC payment with an x402 client, for example
@x402/fetchor@x402/axios. - Send the same request again with the
PAYMENT-SIGNATUREheader. The response carries aPAYMENT-RESPONSEheader with the settlement transaction.
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
const client = new x402Client().register("eip155:8453", new ExactEvmScheme(account));
const pay = wrapFetchWithPayment(fetch, client);
const res = await pay("https://api.organikpi.com/v1/audit?url=https://example.com/pricing");
console.log(await res.json());
Page audit
GET https://api.organikpi.com/v1/audit?url=https://example.com/pricing
| Check | Weight | Passes when |
|---|---|---|
| page_reachable | 20 | The page answers below HTTP 400 |
| indexable | 15 | No noindex in meta robots or X-Robots-Tag |
| ai_search_crawlers_allowed | 15 | robots.txt allows OAI-SearchBot, PerplexityBot and Bingbot |
| server_rendered_text | 15 | At least 300 words in the HTML before JavaScript runs |
| not_blocked_by_user_agent | 10 | A GPTBot user agent gets the page too |
| structured_data | 10 | At least one JSON-LD block |
| question_headings | 5 | At least one H2 phrased as a question |
| meta_description | 5 | A meta description is present |
| llms_txt | 5 | /llms.txt exists on the site |
Only public http and https URLs on ports 80 and 443 are accepted.
Citation check
POST https://api.organikpi.com/v1/citations
Content-Type: application/json
{"prompt": "best crm for small business", "country": "US", "brand": "HubSpot", "domain": "hubspot.com"}
| Field | Rules |
|---|---|
prompt | Required, 3 to 500 characters |
country | Two-letter country code, default US |
engines | Any of chatgpt, google_ai_mode, gemini; default all three |
brand | Optional. Sets brand_mentioned per engine |
domain | Optional bare domain. Sets domain_cited per engine |
The response is HTTP 202 with a job id. Poll GET /v1/citations/{id}; a job usually completes in about 2 minutes, and an engine still running after 10 minutes reports timed_out. Job ids expire after 48 hours.
MCP server
Streamable HTTP at https://api.organikpi.com/mcp. Paid tools follow the x402 MCP transport: an unpaid call returns the payment requirements, and the paid retry carries the payment in _meta["x402/payment"].
| Tool | Price |
|---|---|
audit_page | $0.03 |
check_citations | $0.10 |
get_citation_results | free |
retry_citation_engines | free |
import { createx402MCPClient } from "@x402/mcp";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = createx402MCPClient({
name: "my-agent", version: "1.0.0",
schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});
await client.connect(new StreamableHTTPClientTransport(new URL("https://api.organikpi.com/mcp")));
const result = await client.callTool("audit_page", { url: "https://example.com/pricing" });
Errors
Every error is application/problem+json (RFC 9457). Branch on code, retry only when retryable is true, and wait retry_after_seconds when it is set. charged: false means no payment settled. fix says what to change. MCP tools return the same JSON as the text of an error result.
{
"type": "https://api.organikpi.com/docs#error-invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "The request body is not valid. Nothing was charged.",
"retryable": false,
"charged": false,
"errors": [{"field": "prompt", "message": "Too small: expected string to have >=3 characters"}],
"fix": "Send a JSON object such as {"prompt": "best crm for small business"}."
}
| Code | Status | Retry | When |
|---|---|---|---|
invalid_request | 400 | no | A parameter or body field is missing or wrong. errors lists each field. |
url_not_allowed | 400 | no | The audit url is private, uses another port, or carries credentials. |
not_found | 404 | no | No endpoint at that path. endpoints lists the valid ones. |
method_not_allowed | 405 | no | The path exists but takes another method. See the Allow header. |
payload_too_large | 413 | no | The body is over the limit in max_bytes. |
payment_required | 402 | yes | Unpaid call, or a payment that was not accepted. accepts holds the terms. |
rate_limited | 429 | yes | Too many free calls in a minute. Wait retry_after_seconds. |
job_not_found | 404 | no | The job id is unknown or older than 48 hours. |
no_retry_available | 409 | no | No engine in the job can be retried. |
target_unreachable | 502 | yes | The audited page did not answer or could not be read. |
upstream_failed | 502 | yes | An engine run could not be started. |
payment_service_unavailable | 503 | yes | Payments cannot be verified for a moment. |
internal_error | 500 | yes | Something failed on our side. |
Limits
- Free routes: 60 polls and 10 retries per minute per client.
- Request bodies: 4 KB on the API, 16 KB on MCP.
Refunds
- A request that fails validation is rejected with HTTP 400 before any payment is requested. It costs nothing.
- Payment settles only after the request succeeds. If a paid call fails on our side (HTTP 5xx, or an MCP tool error), the payment is not settled and nothing is charged.
- A citation check is charged when its job starts. An engine that fails or times out can be re-run free, once per engine, with POST /v1/citations/{id}/retry or the retry_citation_engines tool.
- A completed audit, or a citation job with at least one engine answer, is final and not refunded.