terracaribbean.com APIterracaribbean.com ↗
Access Terra Caribbean property listings, details, parishes, amenities, and mortgage calculations for Barbados, Grenada, St. Lucia, and Trinidad & Tobago.
curl -X POST 'https://api.parse.bot/scraper/a3468f98-1cc1-4f7c-955d-0ef4ece21074/search_properties' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"limit": "12",
"offset": "0",
"country_code": "bb",
"listing_type": "sale"
}'Search for property listings across the Caribbean with various filters. Returns paginated results sorted by price ascending. Note: combining regions and amenities filters may cause upstream server errors due to a known site bug; use them separately for reliable results.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results per page. |
| offset | integer | Result offset for pagination. |
| zoning | string | Property category: 'Residential' or 'Commercial'. |
| keyword | string | Search keyword to match against property titles and descriptions. |
| regions | string | Comma-separated list of parishes or regions (e.g. 'St. James,Christ Church'). Values correspond to results from get_parishes endpoint. |
| beds_min | string | Minimum number of bedrooms. |
| amenities | string | Comma-separated list of amenities (e.g. 'Beachfront,Pool'). Values correspond to results from get_amenities endpoint. |
| baths_min | string | Minimum number of bathrooms. |
| price_max | string | Maximum price in USD. |
| price_min | string | Minimum price in USD. |
| country_code | string | Country code: 'bb' (Barbados), 'gd' (Grenada), 'lc' (St. Lucia), 'tt' (Trinidad & Tobago). |
| listing_type | string | Listing type: 'sale' or 'rent'. |
{
"type": "object",
"fields": {
"limit": "integer page size used",
"total": "integer total number of matching listings",
"offset": "integer offset used",
"listings": "array of property listing objects with fields: listing_id, url, title, description, price, address, region, bedrooms, bathrooms, land_area_sqft, zoning, listing_type, display_tag"
},
"sample": {
"data": {
"limit": 12,
"total": 511,
"offset": 0,
"listings": [
{
"url": "https://terracaribbean.com/BB41022/barbados/residential-sale/land/thorpes-land-113/",
"price": "USD $20,000",
"title": "Thorpes Land 113",
"region": "St. James",
"zoning": [
"Residential"
],
"address": "Thorpes Land, Haynesville",
"bedrooms": 0,
"bathrooms": 0,
"listing_id": "BB41022",
"description": "This 2,000 sq.ft. lot is located at Thorpes Land, St. James.",
"display_tag": "Under Offer",
"listing_type": "Sale",
"land_area_sqft": "2,043"
}
]
},
"status": "success"
}
}About the terracaribbean.com API
The Terra Caribbean API provides 7 endpoints for querying property listings, retrieving full listing details, and exploring real estate data across four Caribbean territories. The search_properties endpoint accepts filters for zoning, region, bedrooms, bathrooms, and amenities, returning paginated results with price, address, and listing metadata. Supporting endpoints expose parishes, amenity values, blog posts, and a mortgage payment calculator.
Property Search and Listing Details
The search_properties endpoint accepts up to eight filter parameters — including zoning ('Residential' or 'Commercial'), regions (comma-separated parish names), beds_min, baths_min, amenities, and a free-text keyword — and returns a paginated result set with total, limit, and offset fields alongside a listings array. Each listing object includes listing_id, url, title, description, price, address, region, and bedroom/bathroom counts. One known limitation: combining regions and amenities filters in the same request can trigger upstream server errors; use them in separate calls for reliable results.
For full listing data, get_property_details takes any listing URL from search results and returns the complete record: title, price, description, reference_number, a photos array of image URLs, and an office_info object containing a contact phone number. The reference_number field uses the site's own ID format (e.g. BB41022) and is useful for deduplication.
Location, Parish, and Amenity Reference Data
get_locations returns all covered territories as objects with id (country code), name, and slug. get_parishes accepts a country_code (bb, gd, lc, or tt) and returns an array of parish name strings — the exact values accepted by the regions filter in search_properties. get_amenities returns the full list of valid amenity strings for the same filter parameter. Using these reference endpoints first ensures filter values match what the search endpoint expects.
Mortgage Calculator and Blog Content
calculate_mortgage takes a loan amount, annual rate (as a percentage), and term in years, returning monthly_payment, total_payment, and total_interest. This is useful for building affordability tools alongside listing data. get_blog_posts accepts a country slug and returns an array of posts with title, url, date, and excerpt. Verified working slugs are barbados and grenada; other country slugs may return empty results.
- Build a Caribbean property search interface filtered by parish, zoning, and bedroom count using
search_properties. - Aggregate residential listing prices across Barbados and Grenada to track market trends over time.
- Display full property detail pages including photo galleries and contact info via
get_property_details. - Embed a mortgage affordability calculator using
calculate_mortgagealongside individual listing prices. - Populate region and amenity filter dropdowns from
get_parishesandget_amenitiesto ensure valid inputs. - Sync Terra Caribbean blog content for Barbados and Grenada into a content aggregation pipeline using
get_blog_posts. - Filter commercial properties in specific parishes across multiple Caribbean territories for investment analysis.
| 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 Terra Caribbean have an official developer API?+
What does `get_property_details` return beyond what appears in search results?+
get_property_details adds the full description text, a photos array of image URLs, the property's reference_number, and an office_info object with a contact phone number. Search results return a summary of the listing; this endpoint returns the complete record for a single property URL.Are there any known issues with combining filters in `search_properties`?+
regions and amenities parameters in the same request can cause server errors. The workaround is to apply each filter in a separate request and intersect results client-side. All other filter combinations behave as expected.Does the API cover property listing history or price change data?+
Which countries and territories are covered?+
bb), Grenada (gd), St. Lucia (lc), and Trinidad & Tobago (tt). Parish data is available for all four via get_parishes. Blog posts are currently verified for Barbados and Grenada only; other country slugs may return no results.