Reference
Endpoints
All endpoints live under https://137-23-46-77.sslip.io/v1, accept and return JSON, and need an API key. CORS is open, but keep keys on your server.
Create a job
POST/v1/jobs
Starts an extraction in the background and returns at once with 202 and the job id. Counts as one extract.
| Body field | Type | Description |
|---|---|---|
prompt | string, required | The rows and columns you want, in plain English. Price limits (“under ₹5000”) and brands are understood. |
urls | string[], optional | Up to 10 public pages. Only these pages are opened. Leave empty to let us find pages: product requests search matching stores. |
| Response field | Description |
|---|---|
id | Job id for the calls below. |
status | Starts at queued. |
intent | One sentence saying how we read your prompt. Check it if results look off. |
fields | Columns we expect to return. |
urls | The pages that will be opened, including ones we found for you. |
freeRemaining | Extracts left today. Also sent as the X-RateLimit-Remaining header. |
Get a job
GET/v1/jobs/{id}
Returns progress and, once completed, a preview of up to 50 rows. Poll every 1–2 seconds.
| Field | Description |
|---|---|
status | queued → analyzing → scraping → extracting → validating → completed, or failed. |
urlResults | One entry per page: status, itemCount, method (fetch or browser), and error when a page was skipped. |
schema | Column names in the results. |
itemCount | Total rows. |
preview | First 50 rows. Use the download endpoint for all of them. |
error | Why the job failed, when it did. |
expiresAt | Epoch milliseconds when the job and its data are deleted. |
Pages are skipped, never forced: a page that robots.txt disallows, or that answers with a human check, shows an error in its urlResults entry while the rest of the job continues.
Download results
GET/v1/jobs/{id}/download?format=csv|json
All rows as a file. json (default) returns { prompt, urls, extractedAt, items }; csv returns one column per field. Returns 409 until the job is completed.
curl -s "https://137-23-46-77.sslip.io/v1/jobs/JOB_ID/download?format=json" \
-H "Authorization: Bearer $UE_API_KEY"Check usage
GET/v1/usage
Today’s extract count and your daily limit. Free, and a quick way to test a key.
{ "day": "2026-10-07", "used": 3, "limit": 20 }