API reference

Bulk Optimizations

Optimize multiple products in a single request. Each product is queued for optimization and processed asynchronously.

POST /v1/bulk_optimizations

Create bulk optimization

Submit a list of product IDs for batch optimization. Each product is processed independently — failures on one product don't affect others.

Required attributes

Attribute	Type	Description
product_ids	string[] Required	Array of product UUIDs to optimize

Optional attributes

Attribute	Type	Description
fields	string[]	Fields to optimize. Defaults to all fields if omitted.

Request POST /v1/bulk_optimizations

curl -X POST \
  https://beaconed.ai/api/v1/bulk_optimizations \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"product_ids": ["uuid-1", "uuid-2", "uuid-3"], "fields": ["title", "description"]}'

Response

{
  "data": {
    "queued_count": 3,
    "queued_product_ids": ["uuid-1", "uuid-2", "uuid-3"],
    "skipped_product_ids": [],
    "credits_remaining": 47
  }
}