Based on live API testing of v2 endpoints:
✅ Validated against actual responses:
- /v2/scrape - matches schema ✓
- /v2/map - corrected response structure (direct links array with url objects)
- /v2/crawl - added missing 'url' field to response
- /v2/batch/scrape - added 'url' and 'invalidURLs' fields
- /v2/search - corrected to data.web structure with creditsUsed at root
🔧 Schema corrections:
- MapResponse: Fixed to use direct 'links' array with {url: string} objects
- CrawlResponse: Added required 'url' field for status endpoint
- BatchScrapeResponse: Added 'url' and 'invalidURLs' fields
- SearchResponse: Fixed to use data.web structure + root creditsUsed
- ScrapeMetadata: Added optional title, favicon, language fields
🚮 Removed all v1 endpoints to focus only on v2 API
🏷️ Updated title to 'Firecrawl API v2' and version to '2.0.0'
All schemas now accurately reflect actual API behavior from container 5d8e66d87762
- Complete OpenAPI 3.1 specification for Firecrawl API
- Covers all v1 and v2 endpoints discovered from container inspection
- Includes detailed schemas for requests, responses, and error handling
- Documents scraping, crawling, batch processing, extraction, and job management
- Based on actual API endpoints running in container 5d8e66d87762
- Compatible with existing project OpenAPI patterns (chat.json, r2r.json)
