OrganiKPI AI Search API

Pay per call in USDC on Base with x402. No account, no API key.

Endpoints

CallPriceReturns
GET /v1/audit?url=$0.03AI-readiness score from 0 to 100 for one page, with each check
POST /v1/citations$0.10Job id for one prompt run on ChatGPT, Google AI Mode and Gemini
GET /v1/citations/{id}freeEach engine's answer, cited URLs, top cited domains, brand and domain matches
POST /v1/citations/{id}/retryfreeRe-runs failed engines, once each

Paying with x402

  1. Send the request with no payment. The response is HTTP 402 with a PAYMENT-REQUIRED header listing price, asset, network and recipient.
  2. Sign the USDC payment with an x402 client, for example @x402/fetch or @x402/axios.
  3. Send the same request again with the PAYMENT-SIGNATURE header. The response carries a PAYMENT-RESPONSE header 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

CheckWeightPasses when
page_reachable20The page answers below HTTP 400
indexable15No noindex in meta robots or X-Robots-Tag
ai_search_crawlers_allowed15robots.txt allows OAI-SearchBot, PerplexityBot and Bingbot
server_rendered_text15At least 300 words in the HTML before JavaScript runs
not_blocked_by_user_agent10A GPTBot user agent gets the page too
structured_data10At least one JSON-LD block
question_headings5At least one H2 phrased as a question
meta_description5A meta description is present
llms_txt5/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"}
FieldRules
promptRequired, 3 to 500 characters
countryTwo-letter country code, default US
enginesAny of chatgpt, google_ai_mode, gemini; default all three
brandOptional. Sets brand_mentioned per engine
domainOptional 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"].

ToolPrice
audit_page$0.03
check_citations$0.10
get_citation_resultsfree
retry_citation_enginesfree
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"}."
}
CodeStatusRetryWhen
invalid_request400noA parameter or body field is missing or wrong. errors lists each field.
url_not_allowed400noThe audit url is private, uses another port, or carries credentials.
not_found404noNo endpoint at that path. endpoints lists the valid ones.
method_not_allowed405noThe path exists but takes another method. See the Allow header.
payload_too_large413noThe body is over the limit in max_bytes.
payment_required402yesUnpaid call, or a payment that was not accepted. accepts holds the terms.
rate_limited429yesToo many free calls in a minute. Wait retry_after_seconds.
job_not_found404noThe job id is unknown or older than 48 hours.
no_retry_available409noNo engine in the job can be retried.
target_unreachable502yesThe audited page did not answer or could not be read.
upstream_failed502yesAn engine run could not be started.
payment_service_unavailable503yesPayments cannot be verified for a moment.
internal_error500yesSomething failed on our side.

Limits

Refunds