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

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

Optional attributes

  • Name
    fields
    Type
    string[]
    Description
    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
  }
}