--- title: "PropertyPro.ng API: 7 endpoints, 1 credit per call" description: "PropertyPro.ng API for Nigerian homes, land and commercial property for sale, rent or short let, listings and agents as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/propertypro-ng --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / PropertyPro.ng 1 credit per call 7 endpoints 2 datapoints # PropertyPro.ng API PropertyPro.ng API for Nigerian homes, land and commercial property for sale, rent or short let, listings and agents as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below PropertyPro.ng GET /v1/propertypro-ng/search?category=sale&type=flat-apartment&location=lagos%2Flekki&bedrooms=3 ``` { "success": true, "data": { "applied_filters": { "category": "sale", "type": "flat-apartment", "location": "lagos/lekki", "bedrooms": "3" }, "pagination": { "page": 1, "per_page": 20, "returned": 20, "sponsored_dropped": 2, "filtered_out": 0, "total_reported": 866, "total_capped": false, "has_next_page": true }, "type_counts": [ { "label": "Commercial Property", "count": 3 }, { "label": "Flats/ Apartments", "count": 866 }, { "label": "House", "count": 821 } ], "results": [ { "pid": "2QKRS", "url": "https://propertypro.ng/property/3-bedroom-flat-apartment-for-sale-lekki-phase-1-lekki-lagos-2QKRS", "title": "Spacious 3 Bedroom Apartment With Swimming Pool", "location": "Lekki Phase 1 Lekki Lagos", "kind": "Flat Apartment FOR Sale", "listing_type": "sale", "property_type": "Flat Apartment", "price": 295000000, "price_text": "₦ 295,000,000", "currency": "NGN", "bedrooms": 3, "bathrooms": 3, "tier": "premium_gold", "must_see": true, "features": [ "Gym", "Supermarket Nearby", "Pop Ceiling" ], "image_count": 11, "image": "https://images.propertypro.ng/large/spacious-3-bedroom-apartment-with-swimming-pool-K2pf7Ij0dyIE6Ybvm5G1.jpeg", "images": [ "https://images.propertypro.ng/large/spacious-3-bedroom-apartment-with-swimming-pool-K2pf7Ij0dyIE6Ybvm5G1.jpeg" ], "agent": { "slug": "overhplus", "name": "Overhplus Properties", "logo": "https://images.propertypro.ng/logo/m7Hv0VilIc8xeln1zjGR.jpg", "url": "https://propertypro.ng/agent/overhplus" }, "added_at": "2026-10-28", "updated_at": "2026-11-12" }, { "pid": "7QEWB", "url": "https://propertypro.ng/property/3-bedroom-flat-apartment-for-sale-freedom-way-lekki-lagos-7QEWB", "title": "3 Bedroom Apartment With Bq", "location": "Freedom Way Lekki Lagos", "kind": "Flat Apartment FOR Sale", "listing_type": "sale", "property_type": "Flat Apartment", "price": 360000000, "price_text": "₦ 360,000,000", "currency": "NGN", "bedrooms": 3, "bathrooms": 45, "tier": "premium_gold", "must_see": true, "features": [ "Elevator", "Boys Quater", "24 Hours Security" ], "image_count": 2, "image": "https://images.propertypro.ng/large/luxurious-3-bedroom-apartment-with-bq-qf5nS5EaTzG14BxIsfL3.png", "images": [ "https://images.propertypro.ng/large/luxurious-3-bedroom-apartment-with-bq-qf5nS5EaTzG14BxIsfL3.png" ], "agent": { "slug": "valjes-properties", "name": "VALJES PROPERTIES", "logo": "https://images.propertypro.ng/logo/n2V77oB1n1Hysdl66NUG.png", "url": "https://propertypro.ng/agent/valjes-properties" }, "added_at": "2026-09-15", "updated_at": "2026-11-11" }, { "pid": "0QFSY", "url": "https://propertypro.ng/property/3-bedroom-flat-apartment-for-sale-gbangbala-ikate-lekki-lagos-0QFSY", "title": "Spacious 3 Bedroom Flat", "location": "Gbangbala Ikate Lekki Lagos", "kind": "Flat Apartment FOR Sale", "listing_type": "sale", "property_type": "Flat Apartment", "price": 195000000, "price_text": "₦ 195,000,000", "currency": "NGN", "bedrooms": 3, "bathrooms": 3, "tier": "premium_gold", "must_see": true, "image_count": 10, "image": "https://images.propertypro.ng/large/spacious-3-bedroom-flat-fc0F9iaW3rwl5UVHU0JQ.jpg", "images": [ "https://images.propertypro.ng/large/spacious-3-bedroom-flat-fc0F9iaW3rwl5UVHU0JQ.jpg" ], "agent": { "slug": "abimbola-dada", "name": "ABIMBOLA DADA", "logo": "https://images.propertypro.ng/logo/Jzff6pjYCdrH4x4FNXUb.jpeg", "url": "https://propertypro.ng/agent/abimbola-dada" }, "added_at": "2026-09-22", "updated_at": "2026-11-11" } ] }, "meta": { "endpoint_family": "search", "request_id": "req_e658cd7336684c438af1cf98721608d6", "credits_charged": 1, "credits_remaining": 1823 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | label string | count integer | | --- | --- | --- | | 1 | Commercial Property | 3 | | 2 | Flats/ Apartments | 866 | | 3 | House | 821 | Recorded from our API · 3 items shown · 2 datapoints per item GET /v1/propertypro-ng/search?category=sale&type=flat-apartment&location=lagos%2Flekki&bedrooms=3 2 datapoints ### Other - label string - count integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/propertypro-ng/search?category=sale&type=flat-apartment&location=lagos%2Flekki&bedrooms=3" \ -H "X-API-Key: $API_KEY" ``` PropertyPro.ng · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/propertypro-ng/agent`](https://perceptlayer.com/apis/propertypro-ng/agent) | `slug` | 1 credit | | [GET `/v1/propertypro-ng/agent-listings`](https://perceptlayer.com/apis/propertypro-ng/agent-listings) | `slug` +2 optional | 1 credit | | [GET `/v1/propertypro-ng/agents`](https://perceptlayer.com/apis/propertypro-ng/agents) | none +2 optional | 1 credit | | [GET `/v1/propertypro-ng/autocomplete`](https://perceptlayer.com/apis/propertypro-ng/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/propertypro-ng/facets`](https://perceptlayer.com/apis/propertypro-ng/facets) | none | 1 credit | | [GET `/v1/propertypro-ng/listing`](https://perceptlayer.com/apis/propertypro-ng/listing) | none +3 optional | 1 credit | | [GET `/v1/propertypro-ng/search`](https://perceptlayer.com/apis/propertypro-ng/search) | none +8 optional | 1 credit | Overview ## About the PropertyPro.ng API ## What you can get The PropertyPro.ng API returns PropertyPro.ng property data as JSON through 7 endpoints. - **Search:** `search` takes a `category` (sale, rent or short-let), a `type` (house, flat-apartment, land, commercial-property or co-working-space, and subtypes such as house/detached-duplex, flat-apartment/mini-flat, flat-apartment/self-contain or commercial-property/office-space) and a `location`, with `min_price`, `max_price`, `bedrooms`, `sort` (newest, price\_asc, price\_desc or bedrooms) and `page`. `facets` takes no parameters. - **Listings:** `listing` takes a `url`, `pid` or `slug`. - **Agents:** `agents` takes a `state` (lagos, abuja, rivers, ogun, oyo, kano and the other Nigerian states), with `page`; `agent` takes a `slug`; `agent-listings` takes a `slug`, with `mode` (sale or rent) and `page`. - **Autocomplete:** `autocomplete` takes a `query`, with `limit`. The recorded `search` for three-bedroom flats for sale in lagos/lekki returns `results` with `pid`, `url`, `title`, `location`, `kind`, `listing_type`, `property_type`, `price`, `price_text`, `currency`, `bedrooms`, `bathrooms`, `tier`, `must_see`, `features`, `image_count`, `image`, `images`, `agent`, `added_at` and `updated_at`. It also returns `type_counts`, and `pagination` with `per_page`, `total_reported` (866), `total_capped`, `sponsored_dropped` and `has_next_page`. ## How a call works Search an area: `GET /v1/propertypro-ng/search?category=sale&type=flat-apartment&location=lagos/lekki&bedrooms=3` with your key in the `X-API-Key` header. Each result's `pid` or `url` is what `listing` takes, and its `agent.slug` is what `agent` and `agent-listings` take. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices in naira for flats and houses in Lekki or another Lagos area `Use the PropertyPro.ng API to track asking prices in naira for flats and houses in Lekki or another Lagos area` ### Compare rents for mini flats and self-contain units `Use the PropertyPro.ng API to compare rents for mini flats and self-contain units` ### Watch short lets with \`category=short-let\` `` Use the PropertyPro.ng API to watch short lets with `category=short-let` `` ### List the agents in a state with \`agents\`, then pull an agent's stock with \`agent-listings\` `` Use the PropertyPro.ng API to list the agents in a state with `agents`, then pull an agent's stock with `agent-listings` `` FAQ ## Questions **Do I need a PropertyPro.ng account?** No. You call this PropertyPro.ng API with your Perceptlayer key in the \`X-API-Key\` header, with no PropertyPro.ng login. **How much does the PropertyPro.ng API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **How many results can one search return?** The recorded Lekki search reports a \`total\_reported\` of 866, with \`total\_capped\` false, at 20 results per page. Page with \`page\` while \`has\_next\_page\` is true. **Should I build a PropertyPro.ng scraper instead?** You can, but a PropertyPro.ng scraper is code you maintain: page changes break it, requests get blocked, and PropertyPro.ng's terms govern how you collect data. The PropertyPro.ng API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the PropertyPro.ng API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)