# SpiderFly Public v1 API Docs

AI-readable documentation for SpiderFly public v1 Web Data APIs.

- [Full public v1 Markdown](/api-docs/public-v1.md): complete API overview, authentication, examples, and endpoint list.
- [Public v1 OpenAPI YAML](/api-docs/public-v1/openapi): machine-readable OpenAPI source of truth.
- [Fetch API Markdown](/api-docs/fetch.md): Fetch pages with the lightweight public v1 API.
- [Extract API Markdown](/api-docs/extract.md): Run structured extraction over caller-supplied HTML.
- [Browser API Markdown](/api-docs/browser.md): Run browser-backed scraping and manage browser session resources.
- [Crawl API Markdown](/api-docs/crawl.md): Create and inspect asynchronous crawl jobs.
- [Runs API Markdown](/api-docs/runs.md): Inspect public run records and generated artifacts.
- [YouTube API Markdown](/api-docs/youtube.md): Monitor YouTube channels and run async media jobs.
- [Reddit API Markdown](/api-docs/reddit.md): Monitor Reddit subreddits with JSON listing fetches.
- [Google Maps API Markdown](/api-docs/google-maps.md): Search places and read normalized place details.
- [Google Trends API Markdown](/api-docs/google-trends.md): Collect related queries through durable asynchronous jobs.

Key public diagnostics paths:

- `result.diagnostics.adaptive_extraction`: public selector memory / adaptive extraction explainability.
- `result.diagnostics.browser_debug`: sanitized browser debug capture counts.
- `result.diagnostics.browser_failure`: sanitized browser failure category/stage diagnostics.
- `result.diagnostics.content_quality`: normalized content quality diagnostics.
- `crawl.diagnostics.block_reasons`: crawl blocked diagnostics.
- `crawl.diagnostics.retry.categories`: crawl retry taxonomy.

Use only the public v1 routes documented above. Console, internal operations, and legacy service routes are intentionally excluded.