encuentra24.com APIencuentra24.com ↗
Search and retrieve Encuentra24 real estate listings by region and property type. Get price, bedrooms, size, photos, coordinates, and seller contact.
curl -X GET 'https://api.parse.bot/scraper/ff07139a-22b4-45a9-b71b-ceddbce57f15/search_listings?page=1&limit=2®ion_slug=prov-panama-ciudad-de-panama&country_lang=panama-es&category_slug=bienes-raices-venta-de-propiedades-apartamentos' \ -H 'X-API-Key: $PARSE_API_KEY'
Search real estate listings for a given category (property type) and region slug. Returns paginated results parsed from the public search results page (20 listings per page).
| Param | Type | Description |
|---|---|---|
| page | integer | Results page number. |
| limit | integer | Max listings to return from the page. |
| region_slugrequired | string | Region slug to filter by location. Use get_regions to discover valid slugs. Examples: prov-panama-ciudad-de-panama, prov-panama-ciudad-de-panama-costa-del-este. |
| country_lang | string | Country/language prefix in URL. |
| category_slug | string | Search category slug (property type). |
{
"type": "object",
"fields": {
"query": "object containing the search parameters used",
"listings": "array of listing summary objects with ad_id, title, price, location, details, image_url, url, is_featured",
"pagination": "object with page, per_page, total_pages, next_page, prev_page",
"total_results": "integer total number of matching listings"
},
"sample": {
"data": {
"query": {
"page": 1,
"limit": 3,
"region_slug": "prov-panama-ciudad-de-panama",
"country_lang": "panama-es",
"category_slug": "bienes-raices-venta-de-propiedades-apartamentos"
},
"listings": [
{
"url": "https://www.encuentra24.com/panama-es/bienes-raices-proyectos-nuevos/aura-obarrio-59-apartamentos-nuevos-en-obarrio-1-2-y-3-recamaras/32138864",
"ad_id": "32138864",
"price": {
"raw": "Desde $ 183,000",
"amount": 183000,
"currency": "USD"
},
"title": "Aura Obarrio 59 Apartamentos Nuevos En Obarrio | 1, 2 Y 3 Recámaras",
"details": {
"area_m2": 58,
"bedrooms": 1,
"bathrooms": 1
},
"location": "Obarrio, Ciudad de Panamá",
"image_url": "https://photos.encuentra24.com/t_or_fh_m/f_auto/v1/pa/32/13/88/64/32138864_fd5e3a79239b11dcb84fbb598bb164ac-169f234",
"is_featured": false,
"seller_name": null
}
],
"pagination": {
"page": 1,
"per_page": 20,
"next_page": 2,
"prev_page": null,
"total_pages": 780
},
"total_results": 15591
},
"status": "success"
}
}About the encuentra24.com API
The Encuentra24 API exposes 3 endpoints for accessing public real estate listings across Central America. Use search_listings to query properties by region slug and category, get_listing_details to pull full attributes including price, size in m², bedrooms, bathrooms, coordinates, and photo URLs for a single listing, and get_regions to discover valid location slugs for filtering searches.
Search and Filter Listings
The search_listings endpoint accepts a required region_slug (e.g., prov-panama-ciudad-de-pa) and an optional category_slug for property type. Results are paginated at 20 listings per page. Each listing summary in the response includes ad_id, title, price, location, details, image_url, url, and an is_featured flag. The pagination object returns page, per_page, total_pages, next_page, and prev_page so you can walk through result sets. total_results gives the full count of matching listings.
Listing Detail Data
get_listing_details takes a full listing URL (typically sourced from search_listings results) and returns a structured object with price (broken into amount, currency, and raw), size_m2, bedrooms, location, title, contact (seller name when available), a details key-value map for additional attributes, and a media object containing og_image, photos arrays in large and medium sizes, and coordinates for map placement.
Region Discovery
get_regions takes an optional level integer (2–5) controlling geographic granularity — level 2 returns broad regions like provinces, while higher levels return finer subdivisions. Each returned region object includes name, display, and slug fields. The slug value feeds directly into region_slug in search_listings. An optional country_lang parameter adjusts the country and language context.
- Build a property search tool filtered by Panamanian province using region_slug and category_slug
- Aggregate listing prices and size_m2 data to calculate price-per-m² trends by region
- Extract coordinates from get_listing_details to plot listings on a custom map
- Monitor new listings in a specific category by polling search_listings and tracking ad_id changes
- Compile seller contact data from the contact block for lead generation in a target region
- Pull photo arrays from the media object to build a listing gallery or comparison UI
- Populate a region picker in a frontend app using slugs returned by get_regions
| 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.