Turn any website
into clean JSON.

# start a job with three inputs, get results on your webhook
curl -X POST "https://api.xuivi.com/jobs/start?scraper=etos-product&callbackUrl=https://you.example/hook" \
  -H "x-api-key: $XUIVI_KEY" \
  -H "content-type: application/json" \
  -d '[{"ean":"4210201192237"},{"ean":"8001090304841"},{"ean":"3014260002879"}]'

# → 202 Accepted
{ "jobId": "6278aaf5-b503-4b58-a085-a45d8de04e54", "success": true }

# poll instead of waiting for the callback
curl "https://api.xuivi.com/jobs/6278aaf5-b503-4b58-a085-a45d8de04e54/status" -H "x-api-key: $XUIVI_KEY"
{ "isCompleted": true, "totalItems": 3, "itemsSucceeded": 3, "itemsFailed": 0, "successRate": 100 }

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new("https://api.xuivi.com") };
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("XUIVI_KEY"));

var inputs = new[] { new { ean = "4210201192237" }, new { ean = "8001090304841" } };
var started = await http.PostAsJsonAsync(
    "/jobs/start?scraper=etos-product&callbackUrl=https://you.example/hook", inputs);

var job = await started.Content.ReadFromJsonAsync<StartResponse>();
Console.WriteLine($"job {job!.JobId} accepted");

// later, or from your webhook handler:
var results = await http.GetFromJsonAsync<ScrapeJob>($"/jobs/{job.JobId}");
foreach (var line in results!.ScrapeResults)
    Console.WriteLine($"{line.Input["ean"]} → {line.Status}: {line.Result?["price"]}");

record StartResponse(Guid JobId, bool Success);

import os, requests

API = "https://api.xuivi.com"
headers = {"x-api-key": os.environ["XUIVI_KEY"]}

# zero-config price scraper: one URL in, one product out
r = requests.get(f"{API}/scrape/byUrl", headers=headers, params={
    "url": "https://www.coolblue.nl/product/942567/sonos-era-100-zwart.html",
    "useBrowser": True,      # render JavaScript
    "proxyCountry": "NL",   # residential exit
})
product = r.json()
print(product["productTitle"], product["price"], product["currency"])

# or a whole catalog as a job
job = requests.post(f"{API}/jobs/start", headers=headers,
    params={"scraper": "etos-product"},
    json=[{"ean": e} for e in open("eans.txt").read().split()]).json()
print("job", job["jobId"])

const API = "https://api.xuivi.com";
const headers = { "x-api-key": process.env.XUIVI_KEY, "content-type": "application/json" };

// run a definition for one input, synchronously
const res = await fetch(`${API}/scrape/byDefinition?scraper=bol-offers`, {
  method: "POST",
  headers,
  body: JSON.stringify({ ean: "9200000007373193" }),
});
const { result } = await res.json();
// result is an array because the step has a listSelector
for (const offer of result) console.log(offer.seller, offer.price, offer.delivery);