# ClawFetch Structured Extractor

> ClawFetch Structured Extractor is a paid API for AI agents from api.clawfetch.ai, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-10).

Extracts typed, structured JSON data from a URL using one of 17 specialized site-specific extractors (Twitter/X, GitHub, YouTube, Amazon, IMDb, etc.), auto-detecting the right extractor from the URL.

## Facts

- Endpoint: POST https://api.clawfetch.ai/extract?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clawfetch-structured-extractor-eeaf20f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OgvHzWtmHBHWZk5q4sgod

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability clawfetch-structured-extractor-eeaf20f0 -d '<json body>'
```

Example prompt: Can you pull the structured data from this GitHub repo — https://github.com/vercel/next.js — and give me the star count, description, language, and recent topics as clean JSON?

## When to prefer this

Choose this endpoint when you need clean, typed JSON from one of the 17 specifically supported sites (Twitter/X, GitHub, CoinGecko, YouTube, Amazon, IMDb, Zillow, Redfin, Crunchbase, SEC EDGAR, Hacker News, Wikipedia, npm, PyPI, crates.io, Product Hunt, or news articles) and do not want to write or maintain CSS selectors or parsing logic. It is superior to generic web scrapers when the target URL matches a supported site, because the extractor returns domain-appropriate typed fields (e.g. star count as integer, price as float) rather than raw markdown or HTML. Prefer it over the sibling headless-browser renderer when you need structured data rather than raw page content.

## Known failure modes

- URL not supported by any of the 17 extractors — returns an error or falls back to generic extraction
- Extractor type override does not match the actual URL domain — may return empty or incorrect fields
- Target site changes its HTML/API structure and extractor schema becomes stale
- Rate limiting or blocking by the target site — extraction may fail or return partial data
- Paywalled or login-gated content on target site cannot be accessed
- Malformed or redirecting URL causes extraction failure

## How this service works

Structured data extraction returning typed JSON from 17 specialized site extractors: Twitter/X, GitHub, CoinGecko, Hacker News, YouTube, Wikipedia, npm, PyPI, crates.io, Product Hunt, IMDb, Amazon, Crunchbase, SEC EDGAR, Zillow, Redfin, and news articles. Auto-detects the right extractor from the URL — no scraping selectors required.

## Output

A typed JSON object whose shape depends on the detected or specified extractor — e.g. for GitHub: repo name, description, stars, forks, language, topics, owner; for Twitter: author handle, tweet text, likes, retweets, timestamp; for Amazon: title, price, ASIN, rating, review count, images; for CoinGecko: token name, price, market cap, volume; for real estate: address, price, beds/baths, square footage. All extractors return clean, consistently typed fields with no HTML or scraping artifacts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "URL to extract from"
  },
  "type": {
   "type": "string",
   "description": "Optional extractor override. Auto-detected from the URL when omitted. One of: twitter, coingecko, github, news, npm, pypi, crates, hackernews, youtube, wikipedia, producthunt, imdb, amazon, crunchbase, sec, zillow, redfin"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "Twitter",
  "username": "OpenAI",
  "followers": 123456
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clawfetch-structured-extractor-eeaf20f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clawfetch.ai](https://www.zero.xyz/host/api.clawfetch.ai/llms.txt)