Skip to main content
GET
/
v1
/
batches-airops
/
{batch_id}
Obtenir le statut du lot AirOps
curl --request GET \
  --url https://api.olostep.com/v1/batches-airops/{batch_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "batch_abc123xyz",
  "object": "batch",
  "created_at": 1705315200000,
  "total_urls": 50,
  "status": "completed",
  "batch_mode": true,
  "scraping": {
    "state": "completed",
    "submitted": 50,
    "valid": 50,
    "succeeded": 48,
    "failed": 2,
    "started_at": 1705315200000,
    "completed_at": 1705315500000,
    "error": null
  },
  "analyzing": {
    "state": "completed",
    "items_analyzed": 48,
    "items_needing_enrichment": 30,
    "items_complete": 18,
    "started_at": 1705315500000,
    "completed_at": 1705315502000
  },
  "enriching": {
    "state": "completed",
    "items_to_enrich": 30,
    "items_enriched": 30,
    "items_failed": 0,
    "llm_batch_id": "batch_xyz789",
    "batch_mode": true,
    "started_at": 1705315502000,
    "completed_at": 1705316800000,
    "error": null
  }
}

​
Overview

Returns the current phase and progress metrics for an AirOps batch. Use this for polling if you’re not using webhooks.

​
Response Fields

​
id
string
The batch identifier.
​
object
string
Always "batch".
​
created_at
integer
Unix timestamp (milliseconds) when the batch was created.
​
total_urls
integer
Total number of URLs submitted.
​
status
string
Overall workflow status: pending, in_progress, completed, or failed.
​
batch_mode
boolean
Whether async LLM batch mode is enabled (true) or sync mode (false).
​
scraping
object
Full scraping phase status object (see Webhooks).
​
analyzing
object
Full analyzing phase status object (see Webhooks).
​
enriching
object
Full enriching phase status object (see Webhooks).

​
Example Response

{
  "id": "batch_abc123xyz",
  "object": "batch",
  "created_at": 1705315200000,
  "total_urls": 100,
  "status": "completed",
  "batch_mode": true,
  "scraping": {
    "state": "completed",
    "submitted": 100,
    "valid": 100,
    "succeeded": 98,
    "failed": 2,
    "started_at": 1705315200000,
    "completed_at": 1705315500000,
    "error": null
  },
  "analyzing": {
    "state": "completed",
    "items_analyzed": 98,
    "items_needing_enrichment": 45,
    "items_complete": 53,
    "fields_to_enrich": {
      "page_type": 98,
      "author": 12,
      "date_published": 8,
      "date_modified": 25,
      "brand_mentions": 98
    },
    "started_at": 1705315500000,
    "completed_at": 1705315502000
  },
  "enriching": {
    "state": "completed",
    "items_to_enrich": 45,
    "items_enriched": 44,
    "items_failed": 1,
    "llm_batch_id": "batch_xyz789def",
    "batch_mode": true,
    "started_at": 1705315505000,
    "completed_at": 1705316800000,
    "error": null
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
batch_id
string
required

L'ID du lot à récupérer.

Response

Statut du lot récupéré avec succès.

​
id
string
​
object
enum<string>
Available options:
batch
​
created_at
integer

Horodatage Unix (ms)

​
total_urls
integer
​
status
enum<string>

Statut global du flux de travail.

Available options:
pending,
in_progress,
completed,
failed
​
batch_mode
boolean

Si le mode lot asynchrone LLM est activé

​
scraping
object
​
analyzing
object

Phase d'analyse des écarts - détermine ce qui nécessite un enrichissement LLM.

​
enriching
object

Phase d'extraction LLM via l'API Batch.