Bulk Processing
Batch Operations
Process up to 1,000 valuations in a single request. Perfect for inventory management, catalog updates, and bulk analysis.
1,000
Items per batch
<5min
Typical completion
50%
Cost savings vs single
How It Works
1
Submit
Send up to 1000 URLs
2
Process
Async parallel processing
3
Wait
Poll or receive webhook
4
Download
Get all results
Create Batch Job
// Create a batch job
const response = await fetch('https://api.justkalm.com/v2/batch', {
method: 'POST',
headers: {
'Authorization': 'Bearer jk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
items: [
{ url: 'https://grailed.com/item/123' },
{ url: 'https://depop.com/item/456' },
{ url: 'https://poshmark.com/item/789' },
// ... up to 1000 items
],
callback_url: 'https://your-app.com/webhook/batch',
metadata: { job_name: 'Q4 Inventory Valuation' }
})
});
const { batch_id, status, estimated_completion } = await response.json();
// batch_id: "batch_abc123xyz"
// status: "processing"
// estimated_completion: "2024-12-10T15:30:00Z"Poll Status
// Check batch status
const status = await fetch(
'https://api.justkalm.com/v2/batch/batch_abc123xyz',
{ headers: { 'Authorization': 'Bearer jk_live_xxx' } }
).then(r => r.json());
console.log(status);
// {
// batch_id: "batch_abc123xyz",
// status: "completed",
// total: 1000,
// completed: 1000,
// failed: 3,
// progress: 100,
// results_url: "https://api.justkalm.com/v2/batch/batch_abc123xyz/results"
// }Batch Status States
pending
Job queued
processing
Items being processed
completed
All items finished
failed
Job failed
Best Practices
Use Webhooks
Set a callback_url to receive completion notifications instead of polling. More efficient and reliable.
Handle Partial Failures
Some items may fail. Check the failed count and retrieve individual error details from the results endpoint.
Batch Off-Peak
For best performance, run large batches during off-peak hours (nights and weekends UTC).
Reasonable Sizes
While 1000 items/batch is the limit, 100-500 items often provides the best balance of speed and reliability.
Ready to Process in Bulk?
Batch operations are available on Pro and Enterprise plans.