Open API · Arabic-first · honest numbers

Read, remember and search the web
for your agents.

Three standalone services behind one API key and one usage meter: page reading with a real browser, private semantic memory for Arabic, and a web search that tells you when it hit an official source.

curl -X POST https://agw.orcanox.xyz/v1/read \
  -H "Authorization: Bearer agw_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
response
→ 200
{ "status": 200, "title": "Example Domain",
  "content": "…clean text…", "chars": 1256,
  "fetchedVia": "http", "cached": false }
16 / 20
Pages read with usable content, on the frozen P1 set
bot-walls bypassed, text only
12 / 13
Queries where a trusted official source ranked first
zero junk in the top 3
19 / 25
Arabic memory retrieval, hit@1 · 8/10 colloquial
BGE-M3, 100% local
What you get

Three services, one key, one meter.

Each one is a plain HTTP endpoint with a JSON contract. No SDK required, no hidden state, nothing you can’t reproduce yourself.

Page reading

POST /v1/read

Clean text from any URL. Tries a cache, then HTTP, then an isolated headless browser when the page fights back.

  • Bot-walls bypassed in a sandbox
  • Markdown or plain text output
  • Real token and char counts

Private memory

POST /v1/memory/*

Semantic memory per agent — local BGE-M3 embeddings on pgvector. Your text never leaves the machine we run.

  • Arabic and colloquial aware
  • Scoped per key, deletable
  • No third-party model calls

Web search

POST /v1/search

Two honest tiers: coverage:"official" means an official domain took the top rank — measured, not promised.

  • Official / best-effort, stated per query
  • Fusion of RRF + semantic + lexical
  • Rank reasons returned with results
Five minutes

From zero to a real call.

01

Create an account

Email and password. We verify the address, then you can mint keys — verification exists so nobody mints keys under your address.

02

Mint an API key

The raw key is shown once and stored hashed. Give it read and search scopes, or add memory on a paid plan.

03

Call an endpoint

Send the key as a bearer token. Every request is logged against the key, quotas reset monthly, and 402/429 never consume your quota.

The honest part

We don’t call search “guaranteed”.

Instead of a vague uptime-style promise, every search response carries a coverage field that says exactly what we achieved on that query.

Trusted top result official

The query expressed an official intent and a trusted domain (*.gov.sa, *.gov.eg, *.edu, licensed banks, Wikipedia) took the first rank.

Measured on our frozen set12 / 13
Junk in the top 30

Useful, not guaranteed best-effort

A general web hit — ranked by our fusion of reciprocal-rank, semantic and lexical signals. Useful for discovery; we won’t pretend it’s authoritative.

Rank signals returnedrrf · cosine · lexical
Full methodologyCAPABILITIES.md

Start with 500 free requests.

No card for the free plan. Paid plans are monthly or yearly, billed by Polar as merchant of record — invoices are automatic.

curl -X POST https://agw.orcanox.xyz/v1/read \
  -H "Authorization: Bearer agw_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'