PropertyPro Nigeria Search API lists Nigerian homes, land and commercial property for sale, for rent or for short-let from PropertyPro. Pick a category, narrow by type, location, price and bedrooms, sort and page through results with about 20 listings per page.
Location: pass the location address from the autocomplete endpoint, such as lagos/lekki/ikate. Leave it out to search all of Nigeria.
Filters are honoured. Sponsored cards ignore filters on PropertyPro, so they are dropped and counted in pagination.sponsored_dropped. Any other card that breaks a price, bedroom or category filter is dropped and counted in pagination.filtered_out.
Sort and pages: a sort orders the organic listings. Premium listings stay pinned on top. Pages are one-based. A page past the end returns an empty results list with the page you asked for. total_reported is capped at 10,000 when PropertyPro shows 10,000+ (total_capped is then true).
Prices are in naira. price_period is the period PropertyPro prints (year, month, week, day or sqm) and is null when the listing states none. Coordinates, structured fees and square metres are not published and not returned. Phone numbers are never returned.
A response takes about 10 to 20 seconds. Place lists are cached.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
8 optional filters available.
string
Optional
sale (default), rent or short-let.
example
string
Optional
Property type from the facets endpoint, such as house, flat-apartment, land, commercial-property or flat-apartment/mini-flat. Land and commercial are types.
example
string
Optional
Place address from the autocomplete endpoint, such as lagos/lekki/ikate. Optional; default is all of Nigeria.
Austin, Texas
integer
Optional
Minimum price in naira.
10
integer
Optional
Maximum price in naira. Must be at least min_price.
10
integer
Optional
Exact number of bedrooms, 1 to 10.
10
string
Optional
newest, price_asc, price_desc or bedrooms. Premium listings stay pinned on top.
relevance
integer
Optional
One-based page number, default 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"results": [
{
"pid": "2QFJB",
"url": "https://propertypro.ng/property/3-bedroom-flat-apartment-for-sale-lekki-county-lekki-lagos-2QFJB",
"kind": "Flat Apartment FOR Sale",
"tier": "premium_gold",
"agent": {
"url": "https://propertypro.ng/agent/city-garden-real-estate-ltd",
"logo": "https://images.propertypro.ng/logo/3TXB3liViKYkpWm9kSnm.jpg",
"name": "City Garden Real Estate LTD",
"slug": "city-garden-real-estate-ltd"
},
"image": "https://images.propertypro.ng/large/3-bedroom-penthouse-aGUA28TKnZKPv5hHD9w2.jpg",
"price": 70000000,
"title": "3 Bedroom Penthouse",
"images": [
"https://images.propertypro.ng/large/3-bedroom-penthouse-aGUA28TKnZKPv5hHD9w2.jpg"
],
"added_at": "2026-09-18",
"bedrooms": 3,
"currency": "NGN",
"features": [],
"location": "Lekki County Lekki Lagos",
"must_see": true,
"bathrooms": null,
"price_text": "\u20a6 70,000,000",
"updated_at": "2026-10-25",
"image_count": 15,
"listing_type": "sale",
"price_period": null,
"property_type": "Flat Apartment"
}
],
"pagination": {
"page": 1,
"per_page": 20,
"returned": 20,
"filtered_out": 0,
"total_capped": false,
"has_next_page": true,
"total_reported": 177,
"sponsored_dropped": 1
},
"type_counts": [
{
"count": 1,
"label": "Commercial Property"
},
{
"count": 177,
"label": "Flats/ Apartments"
},
{
"count": 537,
"label": "House"
},
{
"count": 2,
"label": "Land"
}
],
"applied_filters": {
"type": "flat-apartment",
"bedrooms": 3,
"category": "sale",
"location": "lagos/lekki"
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or outside its allowed values. This response is not billable.
{
"errors": {
"bedrooms": [
"The bedrooms field must be at most 10."
]
},
"message": "The request validation failed"
}Upstream Unavailable
PropertyPro could not be reached, or the page could not be confirmed as the requested one. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "PropertyPro could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.