1. Get your API key
dashboard.rastro.ai/settings/api-keys → Create New Key → Copy it.
2. Start an enrichment job
curl -X POST "https://catalogapi.rastro.ai/api/public/enrich" \
-H "Authorization: Bearer rastro_pk_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "Find product specifications",
"items": [{"name": "iPhone 15 Pro"}],
"output_schema": [
{"name": "price", "type": "string", "description": "Current retail price"},
{"name": "weight", "type": "string", "description": "Product weight with units"}
],
"speed": "fast"
}'
{
"job_id": "job_abc123",
"status": "running"
}
This example uses "speed": "fast" for quick results (~1 min), but it’s less thorough. For most use cases, we recommend "speed": "slow" (5-10 min) for more comprehensive enrichment.
3. Poll for results
Query the job ID to check status:
curl "https://catalogapi.rastro.ai/api/public/enrich/job_abc123" \
-H "Authorization: Bearer rastro_pk_..."
{
"status": "completed",
"results": [
{
"original_data": {"name": "iPhone 15 Pro"},
"enriched_fields": {
"price": {
"value": "$999",
"sources": ["https://apple.com/shop/buy-iphone/iphone-15-pro"]
},
"weight": {
"value": "187 grams",
"sources": ["https://apple.com/iphone-15-pro/specs"]
}
},
"all_sources": ["https://apple.com/..."],
"error": null
}
],
"total_items": 1,
"successful": 1
}
Speed options
| Speed | Time | Best for |
|---|
fast | ~1 min | Quick testing, simple lookups |
medium | ~2 min | Balanced speed and quality |
slow | 5-10 min | Production, comprehensive results |
