Turn Websites into APIs.
Brevity is the AEO (Agent Engine Optimization) middleware. We transform messy, dynamic "Human Web" content into structured, token-efficient "Agent Web" JSON.
Quick Start
Account
Register and get 5 free Intelligence Nodes.
API Key
Generate a key in your Dashboard.
Integrate
Send your first POST to /v1/optimize.
Authentication
Authenticate requests by including your API key in the Authorization header.
Extraction Concepts
Extraction Modes
| Mode | Cost | Use Case |
|---|---|---|
| CORE | 1 Node | Single entity extraction. Perfect for Product pages, Articles, and Job posts. |
| DEEP | 5 Nodes | Full-site mapping. Extracts deep entities, structure, and contacts. Exhaustive analysis. |
Intelligence Engines
Powered by Gemini 1.5 Pro
Highest fidelity. Uses visual understanding (screenshot analysis) and massive context windows. Default.
Powered by GPT-3.5 Turbo
Lowest latency (sub-2s). Best for simple pages where speed is critical.
Dynamic Rendering
dynamic_rendering: true launches a headless browser to execute JavaScript.
Recommended: Keep this true for most sites (Amazon, SPAs). Set to false only if you are targeting static HTML blogs/wikis and need raw speed (Turbo Mode).
Billing & Economy
Brevity uses a unified currency called Intelligence Nodes. Unlike "API Requests" which obscure value, Nodes represent a unit of successful AI work.
- Welcome Bonus: Every new account receives 5 Free Nodes.
- No Success, No Pay: If our scraper fails (502/422), your Node is refunded instantly.
- Cache: Requests served from cache (6hr TTL) are Free.
Pay As You Go
Perfect for testing and small projects. Refill anytime securely via Stripe.
Professional
For production workloads. Includes priority support queue.
Integration
curl -X POST https://api.brevity.ch/v1/optimize \
-H "Content-Type: application/json" \
-H "Authorization: Bearer bv_prod_..." \
-d '{
"url": "https://www.amazon.com/dp/B0BSHF7WHW",
"engine": "ACCURACY",
"mode": "CORE",
"dynamic_rendering": true
}'Unified Response Schema
{
"meta": {
"latency_ms": 1420,
"timestamp": "2026-01-10T11:45:00Z",
"engine_version": "Brevity v3.0 (Universal)",
"extraction_method": "DYNAMIC", // or STATIC / VISION
"cached": false
},
"data": {
"product_info": {
"title_raw": "Sony WH-1000XM5 Wireless Headphones",
"title_clean": "Sony WH-1000XM5",
"brand": "Sony"
},
"offer": {
"price": 328.0,
"currency": "USD",
"availability_status": "IN_STOCK",
"stock_count": 15
},
"trust": {
"confidence_score": 0.98,
"critical_flags": []
},
"actions": [
{
"label": "Add to Cart",
"selector": "#add-to-cart-button",
"type": "CART"
}
]
}
}All responses are validated against rigorous Pydantic models. Data you can trust.