Com APIdotproperty.com.ph ↗
Search and retrieve Philippine property listings from dotproperty.com.ph. Filter by city, region, property type, and listing type. Get full listing details including price, agent info, and amenities.
What is the Com API?
The Dot Property Philippines API provides 2 endpoints for searching residential property listings and retrieving full listing details from dotproperty.com.ph. The search_listings endpoint returns paginated results filtered by city, region, property type, and listing type (rent or sale), while get_listing_detail returns structured data including price, description, images, amenities, and agent information for any individual listing URL.
curl -X GET 'https://api.parse.bot/scraper/f39b862b-7b46-4215-98b6-ee80d936af53/search_listings?city=makati&page=1®ion=metro-manila&listing_type=rent&property_type=townhouses' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace dotproperty-com-ph-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Dot Property Philippines API - Search and inspect property listings.
Get your API key from: https://parse.bot/settings
"""
from parse_apis.dot_property_philippines_api import DotProperty, PropertyType, ListingType
client = DotProperty()
# Search for condos for sale in Makati, Metro Manila
for listing in client.listings.search(
city="makati",
region="metro-manila",
property_type=PropertyType.CONDOS,
listing_type=ListingType.SALE,
limit=5,
):
print(listing.title, listing.price, listing.location)
# Get full details for each listing
detail = listing.detail.get()
print(detail.agent_name, detail.price, len(detail.images))
Search for property listings on dotproperty.com.ph filtered by region, city, property type, and listing type. Returns paginated results. The URL is constructed from the property_type, listing_type, region, and city slugs. Invalid slugs result in an upstream error. Each result includes basic info (title, price, location, specs) and a URL for fetching full details.
| Param | Type | Description |
|---|---|---|
| city | string | City slug to search in (e.g. 'makati', 'quezon-city', 'taguig', 'pasig'). |
| page | integer | Page number for pagination. |
| region | string | Region slug to search in (e.g. 'metro-manila', 'cebu', 'davao'). |
| listing_type | string | Listing type: 'rent' or 'sale'. |
| property_type | string | Type of property slug: 'townhouses', 'condos', 'houses'. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"items": "array of listing objects with id, url, title, price, location, bedrooms, bathrooms, area, property_type",
"has_more": "boolean indicating if more pages are available"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": "01978852-ebba-72c6-b29f-f567f86aa53b",
"url": "https://www.dotproperty.com.ph/ads/3-bedroom-townhouse-for-rent-in-san-antonio-metro-manila_e64ff31a234a-a07e-3d72-feeb-74112089",
"area": "120 m2",
"price": "₱ 120,000",
"title": "3 Bedroom Townhouse for rent in San Antonio, Metro Manila",
"bedrooms": "3",
"location": "Makati, Metro Manila",
"bathrooms": "2",
"property_type": "Townhouse"
}
],
"has_more": false
},
"status": "success"
}
}About the Com API
Search Listings
The search_listings endpoint queries the Dot Property Philippines catalog with optional filters: city (e.g. makati, quezon-city), region (e.g. metro-manila, cebu), property_type (e.g. condos, townhouses, houses), and listing_type (rent or sale). Results are paginated via the page parameter. Each item in the items array includes a listing id, url, title, price, location, bedrooms, bathrooms, area, and property_type. The has_more boolean indicates whether additional pages exist. Note that invalid city or region slugs will produce a 404 error from the upstream source — slugs must match the URL patterns used by the site.
Listing Detail
The get_listing_detail endpoint accepts any full listing URL from dotproperty.com.ph — typically sourced from search_listings results — and returns the complete listing record. Response fields include title, price, description, images (array of image URLs), amenities (array of strings, may be empty), agent_name, location_text (breadcrumb path), and json_ld (the page's JSON-LD structured data object, useful for machine-readable property metadata). This endpoint is the primary way to retrieve free-text descriptions and photos for a given property.
Coverage and Scope
The API covers residential properties listed on dotproperty.com.ph across major Philippine regions including Metro Manila, Cebu, and Davao. Listings span condos, townhouses, and houses for both rent and sale. Data freshness reflects what is currently published on the site — delisted properties may return errors or incomplete data if their URLs are no longer active.
The Com API is a managed, monitored endpoint for dotproperty.com.ph — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dotproperty.com.ph changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official dotproperty.com.ph API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate rental condo listings in Makati and Taguig by filtering
search_listingswithcityandlisting_type=rent - Build a property price comparison tool by collecting
pricefields from multiple paginatedsearch_listingsresult sets - Extract agent contact names across listings in Metro Manila using the
agent_namefield fromget_listing_detail - Pull full property descriptions and
imagesarrays for use in a real estate content database - Analyze bedroom and bathroom counts across property types using
bedrooms,bathrooms, andareafrom search results - Ingest
json_ldstructured data from listing detail pages for schema-compliant property records - Monitor new listings in a specific region by paginating
search_listingswith aregionslug and tracking newidvalues
| 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 | 100 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 Dot Property Philippines have an official developer API?+
What does `search_listings` return and how do I filter by property type?+
items array includes id, url, title, price, location, bedrooms, bathrooms, area, and property_type. To filter by property type, pass a valid slug to the property_type parameter — for example condos, townhouses, or houses. You can combine this with city, region, and listing_type filters in the same request.Are there any known limitations with city or region filtering?+
city and region parameters require valid URL slugs that match the site's own URL structure (e.g. quezon-city, not Quezon City). Passing an unrecognized slug will result in a 404 error from the upstream source rather than an empty result set. Test slugs against dotproperty.com.ph URLs before using them in production.Does the API return map coordinates or geolocation data for listings?+
location_text (a breadcrumb path) and json_ld structured data from listing pages, but no explicit latitude/longitude fields. You can fork this API on Parse and revise it to extract coordinate data if it appears in the listing's structured data or page content.