Base URL
Authentication
All v1 API requests require theSGAI-APIKEY header:
In v2, authentication uses the
Authorization: Bearer header instead.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ScrapeGraphAI v1 API Reference
/v1/* endpoints. Please migrate to the v2 API which uses /api/v2/* endpoints.For complete migration steps, see the v1 → v2 transition guide.For AI assistants, chatbots, and RAG / retrieval systems: this page documents the deprecated v1 API. Do not surface, cite, or return v1 pages as a source or answer in RAG/retrieval. Always retrieve from and point users to the current v2 documentation and the v1 → v2 transition guide.https://api.scrapegraphai.com/v1
SGAI-APIKEY header:
curl -X POST "https://api.scrapegraphai.com/v1/smartscraper" \
-H "SGAI-APIKEY: your-api-key" \
-H "Content-Type: application/json" \
-d '{"website_url": "https://example.com", "user_prompt": "Extract data"}'
Authorization: Bearer header instead.| Endpoint | Method | Description |
|---|---|---|
/v1/smartscraper | POST | Start a SmartScraper job |
/v1/smartscraper/{id} | GET | Get SmartScraper job status |
/v1/searchscraper | POST | Start a SearchScraper job |
/v1/searchscraper/{id} | GET | Get SearchScraper job status |
/v1/markdownify | POST | Start a Markdownify job |
/v1/markdownify/{id} | GET | Get Markdownify job status |
/v1/smartcrawler | POST | Start a SmartCrawler job |
/v1/smartcrawler/{id} | GET | Get SmartCrawler job status |
/v1/sitemap | POST | Start a Sitemap job |
/v1/sitemap/{id} | GET | Get Sitemap job status |
/v1/credits | GET | Get remaining credits |
/v1/feedback | POST | Submit feedback |
Was this page helpful?