archello.com APIarchello.com ↗
Access Archello architecture brands, firms, and project data via 4 endpoints. Filter by country, sector, or product type. Search across projects, news, and products.
curl -X GET 'https://api.parse.bot/scraper/c42aa403-4a92-4afd-92f5-a94cd836a94a/list_brands_by_country?code=DE&page=1&country=Germany' \ -H 'X-API-Key: $PARSE_API_KEY'
List manufacturers/brands filtered by country and optional sector or product type. Returns paginated results with brand names, slugs, and URLs.
| Param | Type | Description |
|---|---|---|
| code | string | ISO country code. |
| page | integer | Page number for pagination. |
| sector | string | Sector filter (e.g., residential, commercial). |
| country | string | Country name for filtering brands. |
| product_type | string | Product type filter (e.g., facades, windows-and-doors). |
{
"type": "object",
"fields": {
"brands": "array of brand objects with name, slug, and url",
"country": "string country name used for the query",
"filters": "object containing the sector and product_type filters applied",
"total_items": "integer total number of brands matching the filter, or null if not available",
"current_page": "integer current page number"
},
"sample": {
"data": {
"brands": [
{
"url": "https://archello.com/brand/interface",
"name": "Interface",
"slug": "interface"
},
{
"url": "https://archello.com/brand/3form",
"name": "3form",
"slug": "3form"
}
],
"country": "Netherlands",
"filters": {
"sector": null,
"product_type": null
},
"total_items": 1920,
"current_page": 1
},
"status": "success"
}
}About the archello.com API
The Archello API exposes 4 endpoints covering architecture brands, manufacturers, design firms, and site-wide search across projects, products, and news. The list_brands_by_country endpoint returns paginated brand listings filterable by ISO country code, sector, and product type, while get_brand_detail delivers per-brand profiles including address, offices, email, and website URL. Together the endpoints cover structured access to Archello's directory of architectural suppliers and firms.
Brand and Manufacturer Directory
The list_brands_by_country endpoint accepts an ISO code parameter or a plain country string, and optional sector and product_type filters such as facades or windows-and-doors. Each response page returns an array of brand objects with name, slug, and url, plus a total_items count (which may be null for some queries) and the current_page number. This makes it straightforward to paginate through large country-level brand lists or narrow results to a specific product category.
Firm Listings
The list_firms endpoint works similarly, accepting country, code, and an optional firm_type filter such as architects or engineers. Responses include the same paginated shape: a firms array with name, slug, and url fields, plus total_items and page. Use the returned slugs as input to get_brand_detail to retrieve full profiles for any listed firm, since that endpoint serves both brands and architecture practices.
Brand and Firm Detail Profiles
get_brand_detail takes a single required slug and returns a profile containing name, address, description, email, offices (an array of objects with name and address), and website_url. Not all entries have every field populated — email, website_url, and offices may be null or empty depending on what the brand has published. This is consistent across both manufacturer brands and architecture firm entries.
Site-Wide Search
The search endpoint accepts a free-text query and returns up to 24 results per call, each with title, url, and type. The type field distinguishes between content categories such as project, news, brand, and product, making it usable for content discovery across the full Archello catalog. total_results is included but may be null if a count cannot be parsed from the response.
- Build a supplier directory filtered by country and product type using
list_brands_by_countrywith theproduct_typeparam - Enrich a CRM with architecture firm contact data by combining
list_firmspagination andget_brand_detailemail and address fields - Map office locations for global design firms using the
officesarray returned byget_brand_detail - Discover relevant architecture projects and news by keyword using the
searchendpoint'stype-tagged results - Generate country-level brand coverage reports using
total_itemsacross multiple ISO country codes - Cross-reference a known brand slug from search results against detailed profile data including
website_urlanddescription
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Archello offer an official developer API?+
What does `get_brand_detail` return and when are fields missing?+
name, slug, address, description, email, offices, and website_url for both manufacturer brands and architecture firms. The email, website_url, and offices fields are explicitly nullable — many brand entries on Archello do not publish all contact details publicly, so those fields will be null or empty arrays in the response.Can I filter `list_brands_by_country` by multiple product types at once?+
product_type string per request. Multi-value filtering is not currently supported. You can fork the API on Parse and revise it to add multi-filter logic or parallel request handling.Does the `search` endpoint support pagination to retrieve more than 24 results?+
search endpoint returns up to 24 results per call and does not currently expose a pagination parameter. The API covers site-wide search across projects, brands, firms, news, and products within that result limit. You can fork it on Parse and revise to add page-based pagination if the endpoint supports it.