PropertyPro Nigeria Listing API returns one listing in full: price, bedrooms, bathrooms, toilets, address, the seller's description, features, up to 60 photos and the agent. Pass the url from a search result, or the slug together with the five-character pid.
features lists the lines under a features heading in the seller text. stated_in_description holds land size, service charge, caution fee, agency fee, legal fee and title documents only when the seller wrote them, as raw text. PropertyPro has no structured fees, square metres or coordinates, so none are returned. Phone numbers are never returned.
A listing that was removed or an outdated address returns 404. Take the address from a fresh search result.
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.
3 optional filters available.
string
Optional
Listing address from a search result, for example /property/3-bedroom-flat-apartment-for-sale-ipaja-lagos-6QFXR. Use this or pid with slug.
https://example.com/product
string
Optional
Five-character listing code, for example 6QFXR. Needs slug.
example
string
Optional
Listing slug from the search result address, without the code. Needed with pid.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"pid": "1QGBM",
"url": "https://propertypro.ng/property/5-bedroom-house-for-sale-orchid-lekki-lagos-1QGBM",
"agent": {
"url": "https://propertypro.ng/agent/angel-mercy",
"logo": null,
"name": "Dibah Mercy",
"slug": "angel-mercy"
},
"price": 470000000,
"title": "5 Bedroom Fully Detached Duplex With Bq",
"images": [
"https://images.propertypro.ng/large/five-bedroom-fully-detached-duplex-with-bq-Lo45lQvwapCUTw2bJHRf.jpg",
"https://images.propertypro.ng/large/five-bedroom-fully-detached-duplex-with-bq-VjzIBXCt4C8W257bnoKm.jpg"
],
"address": {
"area": "Lekki",
"text": "Orchid Lekki Lagos",
"state": "Lagos",
"country": "Nigeria"
},
"toilets": 5,
"bedrooms": 5,
"currency": "NGN",
"features": [
"Secured estate",
"Impeccable finishing",
"living areas+ family lounge"
],
"must_see": true,
"tour_url": "https://my.matterport.com/show/?m=jvgMpzRmHZV",
"bathrooms": 5,
"price_text": "\u20a6 470,000,000",
"updated_at": "2026-10-21T19:28:28",
"description": "SALES ALERT\nEXQUISITE 5 BEDROOM FULLY DETACHED DUPLEX WITH BQ, SWIMMING POOL AND HOME OFFICE\n\nPrice: N470M\n\nLocation: Orchid road, Lekki Lagos\n\nProperty Features:\nSecured estate\nImpeccable finishing\nl...",
"image_count": 17,
"listing_type": "sale",
"property_type": "House",
"stated_in_description": {
"land_size": null,
"legal_fee": null,
"agency_fee": null,
"caution_fee": null,
"service_charge": null,
"title_document": "C of O, Governor's consent in process and a building approval"
}
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"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": {
"url": [
"The url field is required when pid is not present."
]
},
"message": "The request validation failed"
}Not Found
The listing or agent does not exist, or the address is outdated. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}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": "listing"
},
"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.