Not Human Search API
Free neutral search for AI agents. Optional provider-funded actions stay separate from organic rank; only an authenticated downstream provider outcome can…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Free neutral search for AI agents. Optional provider-funded actions stay separate from organic rank; only an authenticated downstream provider outcome can create the disclosed provider charge.
Endpoints 36
- GETAPI index — list of endpoints and base URLs
/ - GETAgent-readable commerce catalog
/catalog - POSTCreate a deterministic quote
/quote - POSTCreate a Stripe Checkout URL for a GEO uplift order
/checkout - GETList the optional priority-throughput API key plan and checkout contract
/api-keys/subscribe - POSTCreate a Stripe Checkout session for a paid API key subscription
/api-keys/subscribe - GETGet all category buckets and their counts
/categories - POSTRegister an email to monitor a site's agentic readiness score
/monitor/registerSends an alert via email when the indicated domain's score drops. Returns an unsubscribe URL. - GETSearch for agent-ready sites
/search - GETList provider claims and DNS ownership-check status for the signed-in account
/provider/claimsEach claim exposes the last successful ownership check, next scheduled check, and consecutive failure count without exposing the stored token hash or raw DNS… - POSTBegin an indexed-domain provider claim
/provider/claimsThe returned TXT value must remain published after verification. NHS persists only its SHA-256 token hash, then automatically rechecks domain control; raw DNS… - POSTVerify the claim's DNS TXT challenge and return the callback key once
/provider/claims/:claim_id/verifyKeep the verified TXT value published. NHS stores only the token hash and automatically rechecks it. Paid-action eligibility stops after 3 consecutive… - POSTRotate a pending claim's DNS challenge
/provider/claims/:claim_id/challengeReplaces the pending token hash and returns the new TXT value once. After verification, keep that value published for automatic ownership rechecks. - POSTRevoke a provider claim, keys, offers, and outstanding action authorization
/provider/claims/:claim_id/revoke - POSTRotate the claim-scoped provider callback key
/provider/claims/:claim_id/keys/rotate - GETList offers owned by the signed-in provider account
/provider/offers - POSTCreate a draft provider-funded action offer
/provider/offersTerms-only launch pilot. Drafts cannot appear beside organic results until the provider authenticates the exact capped CPA terms, the owner verifies that… - GETGet one offer owned by the signed-in provider account
/provider/offers/:offer_id - PUTUpdate an owned draft offer
/provider/offers/:offer_id - POSTPause an owned offer
/provider/offers/:offer_id/pause - POSTRecord one provider-authenticated commercial acceptance
/provider/commercial-acceptancesProvider-key-authenticated append-only acceptance only. It cannot establish a deduplicated company, funding, exact terms, renewal, or pilot proof until NHS… - GETRead claim-scoped pilot continuity status
/provider/pilot-statusProvider-key-authenticated read-only status for the key's own DNS-verified claim. It includes provider setup, exact owned offer and terms state, and only… - GETRead privacy-thresholded demand for the authenticated claim domain
/provider/demandProvider-key-authenticated read-only aggregate demand for the key's own current DNS-verified claim domain. The domain is derived from the authenticated claim… - POSTResolve separately consented controlled intent after an observed handoff
/provider/action-tickets/resolveRead-only claim-scoped provider resolution. The body accepts only the exact signed attribution bearer. Resolution is available only after an NHS-observed… - POSTRecord caller-attested principal interest in one controlled next step
/action-interestsCreates a private, query-free Stage 1 demand receipt bound to an exact returned organic domain. It expires with the source search, no later than 30 days after… - POSTPrepare an authorization-attested action for a disclosed paid offer
/action-ticketsRequires a committed organic search receipt and exact principal-consent v1 attestation. Accepts controlled constraints only; no name, email, contact detail,… - POSTRecord an NHS-observed handoff and reveal the provider action URL
/action-tickets/handoffPresents the raw ticket bearer and the separate exact nhs-provider-handoff-consent-v1 principal attestation only in a bounded JSON body, never in the NHS URL… - POSTRecord an idempotent provider-reported action outcome
/provider/outcomesProvider-authenticated assertion, not an independent NHS audit. A charged ticket may later receive an invalid or duplicate credit after expiry or revocation;… - GETRetrieve one receipt owned by the authenticated provider
/provider/receipts/:receipt_id - POSTVerify immutable NHS signature separately from freshness and current accounting state
/action-receipts/verify - GETGet detailed agentic readiness report for a site
/site/:domain - POSTSubmit a site for crawling
/submit - POSTOn-demand agentic readiness check (live crawl)
/checkCrawls the target URL on demand and returns its 7-signal agentic readiness score. Ideal for CI pipelines that should fail when an agent-facing site regresses.… - GETLive-probe a URL for MCP compliance
/verify-mcp?url=stringSends a JSON-RPC tools/list request to the target URL and reports whether it responded with a spec-compliant reply. REST peer of the MCP verify_mcp tool. No… - GETGet index statistics
/stats - GETTop-scored agent-ready sites
/topReturns the highest-scored sites in the index (sorted by agentic_score DESC). Designed as a stable JSON other sites can mirror / embed. Cached 5 min.
API details
- Base URL
https://nothumansearch.ai/api/v1- Authentication
- An API key in the nhs_session cookie
An API key in the X-NHS-Provider-Key header - Operations
- 36 operations on 32 pathsPOST 20GET 15PUT 1
- Response formats
application/json- Description format
- OpenAPI 3.0.3, API version
1.1.0 - Links
- OpenAPI document
How to test the Not Human Search API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Not Human Search API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the nhs_session cookie. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “API index — list of endpoints and base URLs” (GET /), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Not Human Search API?
Free neutral search for AI agents. Optional provider-funded actions stay separate from organic rank; only an authenticated downstream provider outcome can… It is listed under Developer tools and has 36 endpoints.
Who publishes the Not Human Search API?
It is listed from Not Human Search's public API description (an OpenAPI document), not published by Not Human Search on Swastik Codes. Anyone who controls nothumansearch.ai can claim the profile by adding a DNS TXT record.
What is the base URL of the Not Human Search API?
Requests go to https://nothumansearch.ai/api/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Not Human Search API?
It accepts 2 methods: an API key in the nhs_session cookie; an API key in the X-NHS-Provider-Key header.
How many endpoints does the Not Human Search API have?
36 operations on 32 paths (20 POST, 15 GET, 1 PUT).
Is forking the Not Human Search API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.