HuluFlow · Documentation
Introduction
Managed scrape workflows for builders and operators
HuluFlow turns public pages into schedulable tables with optional alerts — wire URL generation → scrape → store → notify on a canvas without maintaining selectors or crawler infra.
Getting started
Build your first workflow in the console in ~15 minutes.
API reference
Endpoints, auth, errors, and credits.
Why HuluFlow
| Pain | Roll your own | HuluFlow |
|---|---|---|
| Selector upkeep | Hand-written CSS breaks weekly | AI field discovery + canvas config |
| Multi-page crawl | Custom pagination + queue | URL generator node + scheduled runs |
| Schedule + storage | Cron + your database | Workflows + datasets built in |
| Change alerts | DIY diff + email | Notify node (new rows / field change) |
| Scale + API | Home-grown REST + retries | Bearer key + `/api/v1/*` |
Three core capabilities
Analyze — discover fields
Paste a public URL and describe columns in plain language; homepage analyze or API preview returns fields and sample rows.
curl -X POST https://huluflow.com/analyze \
-H "Content-Type: application/json" \
-d '{"url": "https://books.toscrape.com/", "requirement": "title, price, url"}'
# Or preview inside a workflow:
curl -X POST https://huluflow.com/api/v1/workflows/{id}/preview \
-H "Authorization: Bearer $HULU_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/list", "fields": ["title", "price"]}'
Run — execute the pipeline
Trigger a workflow run: URL gen → scrape → store → notify. Credits bill per webpage request.
curl -X POST https://huluflow.com/api/v1/workflows/{id}/run \
-H "Authorization: Bearer $HULU_KEY"
Export — read datasets
Page through rows or download CSV/JSON for BI, scripts, or downstream systems.
curl "https://huluflow.com/api/v1/datasets/{id}/rows?page=1&page_size=50" \
-H "Authorization: Bearer $HULU_KEY"
curl -L "https://huluflow.com/api/v1/datasets/{id}/export?format=csv" \
-H "Authorization: Bearer $HULU_KEY" \
-o table.csv