# AGNT Scrape
Base: https://scrape.agnt.gg/scrape/v1
Spec: https://scrape.agnt.gg/openapi.json
Docs: https://scrape.agnt.gg/docs.html
POST /agents {"name":"my-agent"} creates a scoped agent account. Save its one-time secret (scrp_...). Use Authorization: Bearer <secret>. An AGNT sign-in token is also accepted.
POST /scrape {"url","formats":{"markdown","html","text","links","code","screenshot","bytes"},"mainContentOnly","waitForMs","pageRange","maxChargeMicroUSD"} returns every requested format from ONE visit. Web pages are rendered in a real browser. A URL that serves a file (PDF, Word, Excel, PowerPoint, CSV, JSON, RSS, source code...) is converted instead and the response adds a document object. Omit formats for markdown only. Each format is {requested,success,data}; isPartial is true when some failed.
POST /parse?extension=pdf&formats=markdown,links uploads a file: the raw bytes are the body (no multipart), up to 20 MiB. Same response, same price. pageRange ("5" or "2-9") selects PDF pages.
Paid operations require an Idempotency-Key. Reuse it on an uncertain retry to get the receipt instead of a second visit; content is never stored.
maxChargeMicroUSD defaults 0 (included-only); one page or file is 4000 ($0.004) whatever formats you request, subject to account and key budget.
422 page_blocked: the site refused automated access. 404 page_not_found. 504 scrape_timeout. 415 unsupported_file_type. 422 pdf_images_only: a scanned PDF with no text layer. None are charged. No captcha solving, no logins, no private addresses.
POST /quote with the same body prices the page before anything runs.
Pay as you go with $10 minimum prepaid credit, or POST /hosting/purchase with an Idempotency-Key and tier starter|pro|business to activate a standalone monthly plan from that credit. No AGNT subscription required. Monthly page allowances: starter $5 = 2,250, pro $15 = 7,000, business $39 = 18,000. Higher tier mid-month upgrades in place for the difference; lower tier waits for renewal. No rollover.
Funding: Stripe claim link or x402 v2 USDC on Base via POST /funding/x402. Do not sign without explicit owner funding authorization.
Limits: 30 pages/minute per account, 45 seconds per page or file (set client timeouts to 60s), 6 MiB response, 20 MiB file. Sixty failed pages in an hour pauses requests.