Pricing Search API
Search 55,719 construction work items with full cost breakdown, labor, materials, and equipment data. 9 languages. 84 fields per item.
Free & Open
No Auth Required
60 req/min
Base URL
https://buildcalculator.io/api/v1
Endpoints
GETPOST/api/v1/search
Search work items by text query. Returns pricing, labor, materials, and equipment breakdown.
Parameters
| Parameter | Type | Default | Description |
q | string | — | Required. Search query (min 2 characters). Works in any language. |
lang | string | en | Database language: en, ru, de, fr, es, pt, zh, ar, hi |
top | integer | 5 | Number of results to return (1–20) |
Try It Live
Examples
cURL
bash# GET request
curl "https://buildcalculator.io/api/v1/search?q=concrete+foundation&lang=en&top=5"
# POST request
curl -X POST https://buildcalculator.io/api/v1/search -H "Content-Type: application/json" -d '{"q": "concrete foundation", "lang": "en", "top": 5}'
Python
pythonimport requests
response = requests.get("https://buildcalculator.io/api/v1/search", params={
"q": "brick masonry walls",
"lang": "en",
"top": 5
})
data = response.json()
for item in data["results"]:
print(f"{item['name']}: €{item['pricing']['total_per_unit']}/{item['unit']}")
JavaScript
javascriptconst res = await fetch("https://buildcalculator.io/api/v1/search?q=HVAC+ducting&lang=en&top=3");
const data = await res.json();
data.results.forEach(item => {
console.log(`${item.name}: €${item.pricing.total_per_unit}/${item.unit}`);
});
Response Structure
json{
"query": "concrete foundation",
"language": "en",
"results_count": 5,
"results": [
{
"rate_code": "KANE_KAME_KAKAME_KAMECON",
"name": "Concrete preparation device",
"unit": "m3",
"currency": "EUR",
"pricing": {
"total_per_unit": 167.51,
"labor_per_unit": 18.80,
"material_per_unit": 142.92,
"equipment_per_unit": 4.80
},
"cost_breakdown": {
"labor_pct": 11.3,
"material_pct": 85.8,
"equipment_pct": 2.9
},
"labor": { "total_people": 167, "labor_hours_total": 165.87 },
"classification": { "category": "CONSTRUCTION WORK", ... }
}
]
}
GET/api/v1/languages
List all supported languages with item counts.
Supported Languages
en English
ru Russian
de German
fr French
es Spanish
pt Portuguese
zh Chinese
ar Arabic
hi Hindi
GET/api/v1/stats
Database statistics: item counts, categories, languages, metadata.
Rate Limits
| Limit | Value |
| Requests per minute | 60 |
| Max results per request | 20 |
| Authentication | None required |
| Cost | Free |
Error Codes
| Code | Meaning | Action |
400 | Missing or invalid query | Check the q parameter (min 2 chars) |
429 | Rate limit exceeded | Wait and retry |
500 | Server error | Try again or contact support |