Venice Augment

Venice Augment (text parse / scrape / search)

Three lightweight helpers for agent pipelines that need document text, web pages, or search results without running your own parser, crawler, or search account. All three are marked experimental in the docs — request/response shapes may change.

All three accept a Bearer API key or an x402 wallet (SIGN-IN-WITH-X header) — see venice-auth. The balance is checked before the work runs; the charge is applied only after a 200 response. (The OpenAPI x-payment-info advertises a generic dynamic range of $0.001–$10.00; the actual price sheet charge is $0.01.)

POST /augment/text-parser — extract text from documents

Request

Always multipart/form-data:

Accepted file types (matched by MIME type, or by filename extension when the MIME type isn't recognized, e.g. application/octet-stream):

• Structured documents: PDF, EPUB, DOCX, PPTX, XLSX, XLS. Legacy .doc and .ppt are not accepted.
• Text / data: any text/* MIME, plus Markdown, CSV/TSV, JSON/JSONL, YAML, TOML, XML, HTML, RTF, LaTeX, logs, etc.
• Source code: .py, .ts, .js, .go, .rs, .c, .cpp, .java, .sh, .ps1, .sql, … plus extensionless Dockerfile / Makefile (~140 text/data/code extensions are recognized in total).

Anything else → 400 Unsupported file type.

curl -X POST https://api.venice.ai/api/v1/augment/text-parser \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -F "file=@./contract.pdf" \
  -F "response_format=json"

Response

response_format=json:

{
  "text": "…extracted text…",
  "tokens": 3821
}

response_format=text — the raw extracted text as the body (Content-Type: text/plain).

Tips

• DOCX, PPTX, XLSX/XLS and EPUB come back as markdown (spreadsheets as markdown tables). PDFs and text files come back as plain text.
• tokens is a character-based estimate (ceil(chars / 3.2)), not a model tokenizer count — use it for rough budgeting of a downstream chat request.
• Scanned/image-only PDFs are not OCR'd; if nothing can be extracted you get 400 "No text content could be extracted from the file." Run page images through a vision model via /chat/completions instead.
• Password-protected PDFs → 400 "The PDF file is password-protected…"; empty/corrupt PDFs → 400 "The PDF file is empty or invalid."
• Documents are processed in memory and content is not retained after the response. (Operational metadata such as request IDs and error traces may still be logged — this is a no-content-retention guarantee, not a zero-log guarantee.)

POST /augment/scrape — URL → markdown

Request

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

url must be a valid absolute http:// or https:// URL.

curl -X POST https://api.venice.ai/api/v1/augment/scrape \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Response

{
  "url": "https://example.com",
  "content": "# Example Domain\n\nThis domain is for use in …",
  "format": "markdown"
}

How it fetches

Sites that serve markdown directly are returned as-is; otherwise the page is fetched and converted to markdown. Redirects are followed, but a redirect to a private/internal target fails the request (see below). The X/Reddit blocklist is checked against the URL you send, not against redirect targets.

Tips

• Blocked sites — x.com, twitter.com (incl. www. / mobile.) and reddit.com (incl. www. / old. / new.) are rejected immediately with 400. Use enable_x_search or enable_web_search on /chat/completions for those — see venice-chat.
• Blocked URLs — non-HTTP(S) schemes, URLs with embedded credentials, localhost / private / reserved IPs and cloud-metadata hosts return 400. A public hostname that resolves or redirects to such a target fails with 500.
• Unreachable hosts, timeouts and pages with no extractable content return 500 with a message (e.g. "URL unreachable: …"). You are not charged.
• Some sites return a partial body. Check content length before piping it into a model.
• Rate limit: 20 requests/minute per user (429 beyond that). The counter runs before URL validation, so rejected URLs also count.

POST /augment/search — web search

Request

curl -X POST https://api.venice.ai/api/v1/augment/search \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "venice ai api pricing",
    "limit": 5,
    "search_provider": "brave"
  }'

Response

{
  "query": "venice ai api pricing",
  "results": [
    {
      "title": "Pricing — Venice.ai",
      "url": "https://venice.ai/pricing",
      "content": "Venice offers per-token pricing …",
      "date": "2026-04-10"
    }
  ]
}

• date is whatever the provider reports and may be an empty string; don't assume a fixed format.
• Results without a snippet are dropped, so you can get fewer than limit. A search with no hits returns 200 with results: [] (still charged).