File size: 1,964 Bytes
d168db2 f4e3dc7 3dbd083 d168db2 3dbd083 d168db2 f4e3dc7 d168db2 f4e3dc7 d168db2 c3a843f d168db2 c3a843f f4e3dc7 c3a843f d168db2 c3a843f f4e3dc7 c3a843f d168db2 c3a843f f4e3dc7 c3a843f f4e3dc7 c3a843f f4e3dc7 c3a843f f4e3dc7 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | ---
title: Dev Altai API
emoji: ⚡
colorFrom: green
colorTo: green
sdk: docker
pinned: false
license: mit
app_port: 7860
---
# Dev Altai API (Alt Scraper)
A robust SEO scraping API built with FastAPI, Playwright, and advanced anti-bot bypass. Optimized for deployment on Hugging Face Spaces.
## 🚀 Quick Start
### Health Check
```
GET https://ubuntu593-dev-altai.hf.space/health
```
### Start a Scan
```
POST https://ubuntu593-dev-altai.hf.space/api/scanstart?domain=https://example.com&limit=25
```
Or with JSON body:
```bash
curl -X POST "https://ubuntu593-dev-altai.hf.space/api/scanstart" \
-H "Content-Type: application/json" \
-d '{"domain": "https://example.com", "limit": 25}'
```
**Response**: `{"job_id": "abc-123..."}`
### Check Progress
```
GET https://ubuntu593-dev-altai.hf.space/api/progress?job_id=YOUR_JOB_ID
```
### Get Results
```
GET https://ubuntu593-dev-altai.hf.space/api/result?job_id=YOUR_JOB_ID
```
## 📋 Complete API Reference
See [COMPLETE_API_REFERENCE.md](./COMPLETE_API_REFERENCE.md) for full documentation.
## 🔧 Features
- **Tiered Fetching Strategy**: curl_cffi → cloudscraper → Playwright
- **Anti-Bot Bypass**: Playwright Stealth mode with countermeasures
- **Real-time Progress**: WebSocket-like progress tracking
- **Async Processing**: Background job queue with FastAPI
- **Comprehensive Analysis**: Image ALT text, quality checks, and more
## 🛠️ Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/health` | GET | System health check |
| `/api/status` | GET | Server status & connectivity |
| `/api/scanstart` | POST | Start new scan job |
| `/api/progress` | GET | Check scan progress |
| `/api/result` | GET | Get scan results |
## 📦 Deployment
This app uses Docker and is configured for Hugging Face Spaces.
**Requirements**:
- Python 3.10+
- Playwright browsers
- FastAPI + Uvicorn
See [Dockerfile](./Dockerfile) for deployment configuration.
|