Skip to main content
POST
/
public
/
catalogs
/
{catalog_id}
/
enrich
POST Start Enrichment Job
curl --request POST \
  --url https://api.example.com/public/catalogs/{catalog_id}/enrich
Start an enrichment job to enrich all items in a catalog.
curl -X POST "https://catalogapi.rastro.ai/api/public/catalogs/{catalog_id}/enrich" \
  -H "Authorization: Bearer rastro_pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find product specifications",
    "output_schema": [
      {"name": "price", "type": "string", "description": "Current retail price"},
      {"name": "weight", "type": "string", "description": "Product weight with units"}
    ]
  }'
Response:
{
  "job_id": "job_abc123",
  "status": "running",
  "total_items": 150
}

Parameters

ParameterRequiredDefaultDescription
promptYes-Search prompt for web enrichment
output_schemaYes-List of field definitions: [{name, type, description}, ...]
allowed_domainsNoanyRestrict web sources to these domains only
speedNo"medium""fast", "medium", or "slow"

Polling for results

Use the job ID to check status:
curl "https://catalogapi.rastro.ai/api/public/catalogs/{catalog_id}/enrich/job_abc123" \
  -H "Authorization: Bearer rastro_pk_..."
-> Poll job status | Cancel job