# All 50 x402 APIs

> Every grist.tools API with its price, and one page each for what it does, a real request and response, the input schema and the errors it can raise.

Each API is one POST to https://grist.tools/v1/<name>, with no account and no API key. A paid call answers 402 with its price; the caller pays via x402 in USDC on Base and repeats the call. Only a successful call is settled. Input schemas are free at https://grist.tools/v1/<name>/schema.

## Families

| Family | Shelf | APIs | Needs | Ceiling |
| --- | --- | --- | --- | --- |
| [Fetch & extract](https://grist.tools/tools/fetch) | Web | 7 | Requires the network. | 15 s |
| [Feeds & site structure](https://grist.tools/tools/feeds) | Web | 5 | Requires the network. | 15 s |
| [Domain, DNS & network](https://grist.tools/tools/domain) | Web | 5 | Requires the network. | 15 s |
| [Documents](https://grist.tools/tools/documents) | Documents | 14 | Requires a heavy dependency. | 60 s |
| [Images](https://grist.tools/tools/images) | Media | 8 | Requires a heavy dependency. | 94 s |
| [Audio & video](https://grist.tools/tools/av) | Media | 7 | Requires a heavy dependency. | 94 s |
| [Archives & binary](https://grist.tools/tools/archives) | Media | 4 | Requires a heavy dependency. | 94 s |

## Fetch & extract

- [HTML Clean Text API](https://grist.tools/docs/html-clean-text) (`html-clean-text`, $0.002): Fetches a web page and returns the article as clean text and markdown, with its declared metadata.
- [HTTP Headers API](https://grist.tools/docs/http-headers) (`http-headers`, $0.002): Returns the response headers, final status, redirect chain and a security-header grade for a URL, without downloading the body.
- [Link Extract API](https://grist.tools/docs/link-extract) (`link-extract`, $0.002): Fetches a web page and returns every link on it, resolved to absolute, each tagged with its rel, a nofollow flag and whether it stays on the same site.
- [Page Metadata API](https://grist.tools/docs/page-metadata) (`page-metadata`, $0.002): Fetches a page and returns its <head> metadata -- title, description, canonical, language, hreflang, favicon, Open Graph and Twitter cards -- with every URL resolved to absolute.
- [Structured Data Extract API](https://grist.tools/docs/structured-data-extract) (`structured-data-extract`, $0.002): Fetches a web page and returns its embedded machine-readable data -- JSON-LD, OpenGraph, microdata and meta tags -- plus a normalised merge across all four.
- [URL to Markdown API](https://grist.tools/docs/url-to-markdown) (`url-to-markdown`, $0.002): Fetches a web page and returns the article as clean markdown, with its title, byline and final URL.
- [URL Unshorten API](https://grist.tools/docs/url-unshorten) (`url-unshorten`, $0.002): Follows a shortened or tracking URL to its real destination and returns every hop it went through.

## Feeds & site structure

- [Feed Discover API](https://grist.tools/docs/feed-discover) (`feed-discover`, $0.002): Fetches a web page and returns the RSS, Atom and JSON feeds it declares in its <head>, as absolute URLs with their type and title.
- [Robots Check API](https://grist.tools/docs/robots-check) (`robots-check`, $0.002): Fetches robots.txt and answers whether a user agent may crawl a URL, showing the group, the winning rule and every rule that competed with it.
- [RSS Parse API](https://grist.tools/docs/rss-parse) (`rss-parse`, $0.002): Fetches an RSS, Atom or RSS 1.0 feed and returns its channel metadata and a normalised list of items -- id, title, link, summary, content, author, dates and categories -- with every date in ISO 8601 UTC.
- [Sitemap Parse API](https://grist.tools/docs/sitemap-parse) (`sitemap-parse`, $0.002): Parses a sitemap, a sitemap index or a bare origin into a flat, bounded list of URLs with lastmod, changefreq and priority.
- [Well-Known Fetch API](https://grist.tools/docs/wellknown-fetch) (`wellknown-fetch`, $0.002): Fetches and parses a domain's well-known files -- security.txt (RFC 9116), ads.txt and humans.txt -- returning typed fields, seller records and a cross-file summary in one call.

## Domain, DNS & network

- [DNS Lookup API](https://grist.tools/docs/dns-lookup) (`dns-lookup`, free): DNS records for a domain (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA) with their TTLs.
- [Email Validate API](https://grist.tools/docs/email-validate) (`email-validate`, $0.002): Validates an email address: syntax, MX records for its domain, and whether it is a disposable or role account.
- [IP Info API](https://grist.tools/docs/ip-info) (`ip-info`, $0.002): Reverse DNS (PTR) and network ownership for an IP address or a domain.
- [SSL Cert Info API](https://grist.tools/docs/ssl-cert-info) (`ssl-cert-info`, $0.002): Fetches the TLS certificate a host presents: issuer, subject, SAN list, validity window, days to expiry and the full chain.
- [Whois API](https://grist.tools/docs/whois) (`whois`, $0.002): Registration record for a domain over whois: registrar, creation/update/expiry dates, status codes and nameservers, with the raw response.

## Documents

- [CSV to JSON API](https://grist.tools/docs/csv-to-json) (`csv-to-json`, $0.005): Parses a CSV/TSV document into JSON rows, keyed by a header row or as arrays; the delimiter is auto-detected.
- [DOCX to Markdown API](https://grist.tools/docs/docx-to-markdown) (`docx-to-markdown`, $0.005): Converts a Word .docx to Markdown, surfacing anything that did not translate as warnings.
- [EPUB to Text API](https://grist.tools/docs/epub-to-text) (`epub-to-text`, $0.005): Extracts an EPUB’s reading-order text and Dublin Core metadata, chapter by chapter.
- [HTML to PDF API](https://grist.tools/docs/html-to-pdf) (`html-to-pdf`, $0.005): Renders a web page or an inline HTML string to a PDF, returned base64-encoded with its page count.
- [JSON to CSV API](https://grist.tools/docs/json-to-csv) (`json-to-csv`, $0.005): Renders JSON objects as raw CSV with no spreadsheet formula protection; columns are inferred or given, nested values are JSON-encoded.
- [Markdown to PDF API](https://grist.tools/docs/markdown-to-pdf) (`markdown-to-pdf`, $0.005): Renders a Markdown document to a PDF, returned base64-encoded with its page count.
- [OCR Image to Text API](https://grist.tools/docs/ocr-image-to-text) (`ocr-image-to-text`, $0.005): Reads the text out of an image (scan, screenshot, photo) with Tesseract, returned with a mean confidence.
- [PDF Merge API](https://grist.tools/docs/pdf-merge) (`pdf-merge`, $0.005): Concatenates 2–8 source PDFs, in order, into one PDF returned base64-encoded. Maximum output PDF size: 25 MiB before base64 encoding.
- [PDF Metadata API](https://grist.tools/docs/pdf-metadata) (`pdf-metadata`, $0.005): Reads a PDF's page count, document-info fields, version and encryption flag without rendering it.
- [PDF Split API](https://grist.tools/docs/pdf-split) (`pdf-split`, $0.005): Extracts a 1-indexed page selection (e.g. "1,3-4") from a PDF into one new PDF, returned base64-encoded. Maximum output PDF size: 25 MiB before base64 encoding.
- [PDF to Markdown API](https://grist.tools/docs/pdf-to-markdown) (`pdf-to-markdown`, $0.005): Converts a PDF to Markdown, inferring headings from font size (best-effort, not layout-perfect; no OCR).
- [PDF to Text API](https://grist.tools/docs/pdf-to-text) (`pdf-to-text`, $0.005): Extracts the text layer of a PDF, page by page, in reading order (no OCR).
- [PPTX to Text API](https://grist.tools/docs/pptx-to-text) (`pptx-to-text`, $0.005): Extracts the slide text of a PowerPoint .pptx, slide by slide, in order (body text only, up to 1,000 slides).
- [XLSX to JSON API](https://grist.tools/docs/xlsx-to-json) (`xlsx-to-json`, $0.005): Reads an Excel .xlsx into JSON rows, keyed by a header row or as arrays; dates become ISO strings. Archives are limited to 64 worksheets.

## Images

- [Color Palette Extract API](https://grist.tools/docs/color-palette-extract) (`color-palette-extract`, $0.003): Extracts an image's dominant colours as a small palette (hex, RGB and coverage fraction).
- [Favicon Extract API](https://grist.tools/docs/favicon-extract) (`favicon-extract`, $0.003): Discovers a page's favicons and returns the best one decoded to a normalised PNG with its size.
- [Image Compress API](https://grist.tools/docs/image-compress) (`image-compress`, $0.003): Re-encodes an image in its own format at a lower quality to shrink the file, keeping its dimensions.
- [Image Convert API](https://grist.tools/docs/image-convert) (`image-convert`, $0.003): Transcodes an image to PNG, JPEG or WebP at a chosen quality, returned base64-encoded.
- [Image Metadata API](https://grist.tools/docs/image-metadata) (`image-metadata`, $0.003): Reads an image's EXIF/ICC/IPTC/XMP metadata and can return a copy with all metadata stripped.
- [Image Probe API](https://grist.tools/docs/image-probe) (`image-probe`, $0.003): Reports an image's format and pixel dimensions from its header, without decoding the pixels.
- [Image Resize API](https://grist.tools/docs/image-resize) (`image-resize`, $0.003): Resizes an image to a target width/height under a chosen fit, returned base64-encoded.
- [SVG to PNG API](https://grist.tools/docs/svg-to-png) (`svg-to-png`, $0.003): Rasterises an SVG to a PNG at a chosen resolution, returned base64-encoded.

## Audio & video

- [Audio Convert API](https://grist.tools/docs/audio-convert) (`audio-convert`, $0.003): Transcodes an audio file between WAV, MP3, FLAC, AAC and Opus, with an optional bit rate and sample rate.
- [Audio Extract API](https://grist.tools/docs/audio-extract) (`audio-extract`, $0.003): Extracts the audio track from a video (or any container) and returns it in a chosen audio format.
- [Media Probe API](https://grist.tools/docs/media-probe) (`media-probe`, $0.003): Reads a media file's container, duration, bit rate and per-stream codec/resolution without decoding it.
- [Subtitle Convert API](https://grist.tools/docs/subtitle-convert) (`subtitle-convert`, $0.003): Converts a subtitle track between SubRip (.srt) and WebVTT (.vtt), normalising the cues.
- [Subtitle Extract API](https://grist.tools/docs/subtitle-extract) (`subtitle-extract`, $0.003): Extracts a text subtitle track from a media container (MKV, MP4, WebM) as SubRip or WebVTT.
- [Video Thumbnail API](https://grist.tools/docs/video-thumbnail) (`video-thumbnail`, $0.003): Grabs a single frame from a video at a chosen timestamp as a PNG or JPEG, optionally scaled to a width.
- [Waveform Data API](https://grist.tools/docs/waveform-data) (`waveform-data`, $0.003): Reduces an audio file to a fixed number of normalised waveform peaks for drawing, without shipping samples.

## Archives & binary

- [Archive Extract File API](https://grist.tools/docs/archive-extract-file) (`archive-extract-file`, $0.003): Extracts one named entry from a remote zip, tar or tar.gz and returns its bytes (base64) with a sha256.
- [Archive Inspect API](https://grist.tools/docs/archive-inspect) (`archive-inspect`, $0.003): Lists the entries of a remote zip, tar or tar.gz (paths, sizes, compression and CRC) without extracting any of them.
- [File Type Detect API](https://grist.tools/docs/file-type-detect) (`file-type-detect`, $0.003): Detects a remote file's true type from its magic bytes, returning the canonical extension and media type.
- [Remote File Hash API](https://grist.tools/docs/remote-file-hash) (`remote-file-hash`, $0.003): Computes the sha256, sha1 or md5 digest of a remote file, buffered in memory under a size cap, for checksum verification.

## 91 conversions

Each one is a ready-made call to an API above, with its own page.

- AIFF to: [AAC](https://grist.tools/tools/aiff-to-aac), [FLAC](https://grist.tools/tools/aiff-to-flac), [MP3](https://grist.tools/tools/aiff-to-mp3), [Opus](https://grist.tools/tools/aiff-to-opus), [WAV](https://grist.tools/tools/aiff-to-wav)
- AVI to: [AAC](https://grist.tools/tools/avi-to-aac), [FLAC](https://grist.tools/tools/avi-to-flac), [JPEG](https://grist.tools/tools/avi-to-jpeg), [MP3](https://grist.tools/tools/avi-to-mp3), [Opus](https://grist.tools/tools/avi-to-opus), [PNG](https://grist.tools/tools/avi-to-png), [SRT](https://grist.tools/tools/avi-to-srt), [WebVTT](https://grist.tools/tools/avi-to-vtt), [WAV](https://grist.tools/tools/avi-to-wav)
- AVIF to: [JPEG](https://grist.tools/tools/avif-to-jpeg), [PNG](https://grist.tools/tools/avif-to-png), [WebP](https://grist.tools/tools/avif-to-webp)
- CSV to: [JSON](https://grist.tools/tools/csv-to-json)
- DOCX to: [Markdown](https://grist.tools/tools/docx-to-markdown)
- EPUB to: [plain text](https://grist.tools/tools/epub-to-text)
- FLAC to: [AAC](https://grist.tools/tools/flac-to-aac), [MP3](https://grist.tools/tools/flac-to-mp3), [Opus](https://grist.tools/tools/flac-to-opus), [WAV](https://grist.tools/tools/flac-to-wav)
- GIF to: [JPEG](https://grist.tools/tools/gif-to-jpeg), [PNG](https://grist.tools/tools/gif-to-png), [plain text](https://grist.tools/tools/gif-to-text), [WebP](https://grist.tools/tools/gif-to-webp)
- HTML to: [Markdown](https://grist.tools/tools/html-to-markdown), [PDF](https://grist.tools/tools/html-to-pdf), [plain text](https://grist.tools/tools/html-to-text)
- JPEG to: [PNG](https://grist.tools/tools/jpeg-to-png), [plain text](https://grist.tools/tools/jpeg-to-text), [WebP](https://grist.tools/tools/jpeg-to-webp)
- JSON to: [CSV](https://grist.tools/tools/json-to-csv)
- Markdown to: [PDF](https://grist.tools/tools/markdown-to-pdf)
- MKV to: [AAC](https://grist.tools/tools/mkv-to-aac), [FLAC](https://grist.tools/tools/mkv-to-flac), [JPEG](https://grist.tools/tools/mkv-to-jpeg), [MP3](https://grist.tools/tools/mkv-to-mp3), [Opus](https://grist.tools/tools/mkv-to-opus), [PNG](https://grist.tools/tools/mkv-to-png), [SRT](https://grist.tools/tools/mkv-to-srt), [WebVTT](https://grist.tools/tools/mkv-to-vtt), [WAV](https://grist.tools/tools/mkv-to-wav)
- MP3 to: [AAC](https://grist.tools/tools/mp3-to-aac), [FLAC](https://grist.tools/tools/mp3-to-flac), [Opus](https://grist.tools/tools/mp3-to-opus), [WAV](https://grist.tools/tools/mp3-to-wav)
- MP4 to: [AAC](https://grist.tools/tools/mp4-to-aac), [FLAC](https://grist.tools/tools/mp4-to-flac), [JPEG](https://grist.tools/tools/mp4-to-jpeg), [MP3](https://grist.tools/tools/mp4-to-mp3), [Opus](https://grist.tools/tools/mp4-to-opus), [PNG](https://grist.tools/tools/mp4-to-png), [SRT](https://grist.tools/tools/mp4-to-srt), [WebVTT](https://grist.tools/tools/mp4-to-vtt), [WAV](https://grist.tools/tools/mp4-to-wav)
- Ogg to: [AAC](https://grist.tools/tools/ogg-to-aac), [FLAC](https://grist.tools/tools/ogg-to-flac), [JPEG](https://grist.tools/tools/ogg-to-jpeg), [MP3](https://grist.tools/tools/ogg-to-mp3), [Opus](https://grist.tools/tools/ogg-to-opus), [PNG](https://grist.tools/tools/ogg-to-png), [SRT](https://grist.tools/tools/ogg-to-srt), [WebVTT](https://grist.tools/tools/ogg-to-vtt), [WAV](https://grist.tools/tools/ogg-to-wav)
- PDF to: [Markdown](https://grist.tools/tools/pdf-to-markdown), [plain text](https://grist.tools/tools/pdf-to-text)
- PNG to: [JPEG](https://grist.tools/tools/png-to-jpeg), [plain text](https://grist.tools/tools/png-to-text), [WebP](https://grist.tools/tools/png-to-webp)
- PPTX to: [plain text](https://grist.tools/tools/pptx-to-text)
- SRT to: [WebVTT](https://grist.tools/tools/srt-to-vtt)
- SVG to: [JPEG](https://grist.tools/tools/svg-to-jpeg), [PNG](https://grist.tools/tools/svg-to-png), [WebP](https://grist.tools/tools/svg-to-webp)
- TIFF to: [JPEG](https://grist.tools/tools/tiff-to-jpeg), [PNG](https://grist.tools/tools/tiff-to-png), [plain text](https://grist.tools/tools/tiff-to-text), [WebP](https://grist.tools/tools/tiff-to-webp)
- TSV to: [JSON](https://grist.tools/tools/tsv-to-json)
- WAV to: [AAC](https://grist.tools/tools/wav-to-aac), [FLAC](https://grist.tools/tools/wav-to-flac), [MP3](https://grist.tools/tools/wav-to-mp3), [Opus](https://grist.tools/tools/wav-to-opus)
- WebP to: [JPEG](https://grist.tools/tools/webp-to-jpeg), [PNG](https://grist.tools/tools/webp-to-png), [plain text](https://grist.tools/tools/webp-to-text)
- WebVTT to: [SRT](https://grist.tools/tools/vtt-to-srt)
- XLSX to: [JSON](https://grist.tools/tools/xlsx-to-json)

This page as HTML: https://grist.tools/docs. Every page of grist.tools has a Markdown version at its address plus .md.
