# based-seo DataForSEO Gateway

> Pay-per-call access to 337 DataForSEO SEO/GEO endpoints. Agents pay per request in USDC via x402 on Base - no account, no API key. Discovery is public; only execution is paid.

## How to pay (x402)

- Protocol: x402 v2, scheme "exact", asset USDC, network base or base-sepolia (set via X402_NETWORK).
- Send your request to `POST /api/v3/{slug}`. If payment is required you get HTTP 402 with a `PAYMENT-REQUIRED` header describing the amount and payTo.
- Retry the same request with a `PAYMENT-SIGNATURE` header (an EIP-3009 USDC authorization). On success the response carries `PAYMENT-RESPONSE`.
- Per-endpoint prices are published in the manifest and OpenAPI (`x-price-usd`). Some prices are marked `estimated` and disclosed as such.

## Machine-readable index

- [API manifest](https://based-seo.com/api/v3/manifest): every public endpoint with slug, method, price, and params (JSON).
- [OpenAPI 3.1](https://based-seo.com/openapi.json): full schema for humans and codegen, with x-price extensions.

## Endpoint groups

- AI Optimization API: 40 endpoints
- App Data API: 18 endpoints
- Appendix: 3 endpoints
- Backlinks API: 24 endpoints
- Business Data API: 25 endpoints
- Content Analysis API: 12 endpoints
- Content Generation API: 9 endpoints
- DataForSEO Labs API: 56 endpoints
- Domain Analytics API: 12 endpoints
- Keywords Data API: 43 endpoints
- Merchant API: 19 endpoints
- OnPage API: 9 endpoints
- SERP API: 67 endpoints

## Notes

- The manifest is the source of truth for the full endpoint list and pricing.
- Internal task-retrieval endpoints are not exposed and never appear in any index.