HTTP API

Search the web.
Stay in control.

Find sources for your agents with one account. Use scoped keys, explicit budgets and request receipts. No AGNT app subscription is required.

Open your account →

1. Create an account

POST https://search.agnt.gg/search/v1/agents
Content-Type: application/json

{"name":"research-agent","allowPrepaid":true}

2. Fund and authorize usage

Use the returned funding link or x402. Human owners enable extra usage and set account budgets in the app. Initial agent credentials carry execution, receipts and funding scopes with a $10 monthly key cap; an explicit request spending cap is also required.

3. Search

POST /search/v1/search
Authorization: Bearer YOUR_SEARCH_KEY
Idempotency-Key: unique-request-20260918-001
Content-Type: application/json

{"query":"agent infrastructure","num":5,"sort":"relevance","maxChargeMicroUSD":15000}

Returns success, query, resultsCount, and results containing title, link, snippet and source. Default 5, maximum 10. Date sort is optional. A successful empty search is charged.

Payments

Stripe Checkout funds $10, $25 or $50 prepaid credit. Credit appears only after verified payment. Requests debit prepaid credit only when explicitly authorized. No unlimited allowance.

Monthly plans

Optional and standalone — no AGNT subscription required. POST /hosting/purchase with an Idempotency-Key and a tier of starter, pro or business. The price is debited from prepaid credit, so there is never an automatic card charge. Starter $5 includes 150 searches; Pro $15 includes 500; Business $39 includes 1,400. Buying a higher tier mid-month upgrades in place and charges only the difference; moving down happens at renewal. Plans renew only when you enable renewal, and allowances never roll over.

x402 / USDC on Base

POST /funding/x402 with amountCents and Idempotency-Key using a funding-scoped key.
Read HTTP 402 and the base64 PAYMENT-REQUIRED header.
Authorize exactly the stated USDC amount, destination, chain and validity in your wallet.
POST /funding/x402/:orderId with PAYMENT-SIGNATURE.
Read PAYMENT-RESPONSE and the credited receipt. If pending, poll that order; never pay a second order to recover a timeout.

Search does not hold wallet signing keys. Funding does not authorize unlimited usage.

Limits & retries

Google search costs $0.015 per successful query (up to ten results). A successful search draws on your included allowance first.
maxChargeMicroUSD: 0 means included-only. Cash also requires account authorization and available account/key budgets.
30 attempted searches per account per minute. Searches have a 20-second provider limit; configure clients for at least 30 seconds.
1 MiB returned JSON. Excessive content fails, not silently truncates.
Failed requests release reservations, but attempt limits still apply: five failed attempts per hour pauses further requests. Reuse the same idempotency key for uncertain retries, never a fresh key.
We store receipts, not response content. A retry returns the receipt and resultRetained:false, without re-executing. Save the original result on your side.

Errors

400 invalid input · 401 invalid credentials · 403 insufficient scope · 402 funding/spending limit · 409 conflicting or running request · 429 rate/capacity limit · 503 unavailable provider or execution failure. Check the stable error code and request receipt before retrying.

Keys

search:execute, search:read and search:fund are independent. Keys last until you revoke them; set an optional expiresAt when creating one if you want a short-lived key. Email sign-in is required to create keys or change spending controls. Never put API secrets in browser pages you publish.

Signed notifications

Register up to three public HTTPS receivers in the app or POST /webhooks. Save the one-time signing secret. Verify X-AGNT-Signature as v1=HMAC-SHA256(secret, timestamp + "." + rawBody), using X-AGNT-Timestamp with a five-minute tolerance. Deduplicate X-AGNT-Event-ID. Delivery is at least once with up to three attempts; history is retained seven days. Notifications contain receipts and state, never search content.

Privacy & acceptable use

Search queries go to Google. AGNT retains account, payment and request metadata for operation and accounting, but does not persist returned search content. Avoid sending secrets in queries or URLs. Use only content you are permitted to access; no authentication bypass, abusive crawling or access to private infrastructure.

Monthly plans are optional and are paid from prepaid credit. Allowances purchased under earlier pricing keep their original terms until they expire and will not renew on their own. Plan and AGNT bundle allowances reset each period; no rollover. Financial records are retained for accounting; request logs exclude raw query text and result bodies. Contact support@agnt.gg for account, billing or data requests.

Google currently provides the search backend and has announced a January 1, 2027 API transition. AGNT's public contract is independent of the provider.

Client downloads

JavaScript client →Python client →OpenAPI →

Save each response when it arrives. Use the same idempotency key for an uncertain retry; receipts do not include previously returned content.

Already subscribe to AGNT?

All paid AGNT subscriptions include Search at no additional subscription charge, matching the Starter, Pro, and Business allowances: Personal 150 searches, Always On 500 searches, Business and Enterprise 1,400 searches — per UTC month, no rollover. A Search plan can be bought on top, and the larger of the two allowances applies.

provider_unavailable (HTTP 503) means the search provider did not answer; provider_quota means the provider is temporarily rate-limited. Both are safe to retry with the same idempotency key. Failed attempts are not billed but remain subject to attempt limits.

Search the web.Stay in control.