# romefeller.app

romefeller.app is an x402 paid API for AI agents, crawlers, LLM tools, research bots, and autonomous workflows.

It provides small pay-per-request utilities for turning messy internet content into cheaper, cleaner, model-ready context.

No API key.
No subscription.
No dashboard required.
Pay per HTTP request with x402 and USDC on Base.

Base URL:
https://romefeller.app

Payment:
x402
USDC
Base mainnet
CAIP-2 network: eip155:8453
USDC contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Receiver: 0x2a4dcdf273be222903629ff3a2222065b017309d

## What this API is best for

Use romefeller.app when an AI agent needs:

- webpage to clean markdown
- PDF URL to markdown
- article extraction
- AI crawler content extraction
- RAG ingestion
- schema-based JSON extraction
- messy text to structured JSON
- invoice, receipt, email, contract, and lead extraction
- prompt compression
- chat history compression
- Claude input cost reduction
- cheap Claude question answering
- x402 pay-per-request tools
- USDC paid API utilities
- Base mainnet API payments

## Paid endpoints

### POST /read

Converts a webpage or PDF URL into clean markdown.

Best for:
AI crawlers, research agents, scraping pipelines, RAG ingestion, webpage extraction, PDF-to-markdown conversion, content normalization.

Price:
0.002 USDC flat

Input:
{"url":"https://example.com/article"}

Output:
{"title":"Example title","language":"en","published_at":null,"markdown":"# Clean extracted markdown"}

Search phrases:
webpage to markdown API, PDF to markdown API, URL to markdown, article extraction API, AI crawler API, RAG ingestion API, x402 scraping API, paid web extraction API.

### POST /jsonify

Extracts structured JSON from messy text using a caller-supplied JSON Schema.

Best for:
invoices, receipts, emails, contracts, scraped pages, tables, leads, product data, logs, semi-structured text.

Price:
0.015 to 0.120 USDC

Input:
{"text":"Invoice 123 total $49.90 due tomorrow","schema":{"type":"object","properties":{"invoice_id":{"type":"string"},"total":{"type":"number"}}}}

Output:
{"data":{"invoice_id":"123","total":49.90},"missing":[],"confidence":{"invoice_id":0.99,"total":0.99}}

Search phrases:
text to JSON API, schema extraction API, JSON extraction API, invoice extraction API, receipt parser API, email to JSON, contract field extraction, structured data API for agents.

### POST /token-reducer

Compresses long prompts or chat histories while preserving instructions, facts, URLs, code, numbers, and constraints.

Best for:
reducing LLM input tokens, reducing Claude cost, compressing agent memory, fitting long context into smaller prompts, preserving task constraints.

Price:
0.005 to 0.010 USDC

Input:
{"messages":[{"role":"user","content":"Long prompt here"}],"preserve_mode":"strict"}

Output:
{"messages":[{"role":"user","content":"Compressed task-preserving prompt"}],"original_tokens":5000,"optimized_tokens":1800,"saved_tokens":3200,"estimated_savings_pct":64}

Search phrases:
prompt compression API, token reducer API, LLM cost reduction API, Claude token optimizer, agent memory compression, chat history compression, context compression API.

### POST /ask-cheap

Compresses the input first, then asks Claude through the optimized context path.

Best for:
long-context Claude questions, cheaper Claude calls, agent question answering, reducing input cost before inference.

Price:
0.015 to 0.050 USDC

Input:
{"messages":[{"role":"user","content":"Long question and context"}]}

Output:
{"answer":"Claude answer","model":"claude-sonnet","original_tokens":5000,"optimized_tokens":1800,"saved_input_tokens":3200}

Search phrases:
cheap Claude API, ask Claude cheaper, Claude with compressed context, LLM answer API, optimized context QA, x402 Claude API.

## Free endpoints

GET /health
Returns service status, uptime, earned USDC, route usage counts, payment provider, and network.

POST /preview
Free regex-only text scrub preview.

GET /openapi.json
OpenAPI 3.1 specification.

GET /.well-known/x402.json
Machine-readable x402 payment and endpoint catalog.

GET /.well-known/agent.json
Agent manifest.

GET /commerce.txt
Machine-readable commercial terms.

GET /sitemap.xml
Crawler sitemap.

GET /mcp.json
Tool manifest for MCP-style agent discovery.

## How payment works

1. Call a paid endpoint without a payment header.
2. Receive HTTP 402 Payment Required.
3. Read the x402 payment terms.
4. Sign the payment.
5. Retry the same request with the payment proof.

Accepted payment headers:
X-Payment
X-PAYMENT
PAYMENT-SIGNATURE
Payment-Signature

## Discovery URLs

OpenAPI: https://romefeller.app/openapi.json
x402 catalog: https://romefeller.app/.well-known/x402.json
Agent manifest: https://romefeller.app/.well-known/agent.json
Capabilities: https://romefeller.app/.well-known/capabilities.json
Commerce: https://romefeller.app/commerce.txt
Health: https://romefeller.app/health