JK
JustKalm
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.

© 2025 JustKalm. Process at scale.