1 credit per call7 endpoints2 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 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 OKJSONX-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.

#	labelstring	countinteger
1	Commercial Property	3
2	Flats/ Apartments	866
3	House	821

[
  {
    "label": "Commercial Property",
    "count": 3
  },
  {
    "label": "Flats/ Apartments",
    "count": 866
  },
  {
    "label": "House",
    "count": 821
  }
]

label,count
Commercial Property,3
Flats/ Apartments,866
House,821

Recorded from our API · 3 items shown · 2 datapoints per itemGET /v1/propertypro-ng/search?category=sale&type=flat-apartment&location=lagos%2Flekki&bedrooms=3

2 datapoints

Other

labelstring
countinteger

Playground

Run this API

cURLshell

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`	`slug`	1 credit
GET`/v1/propertypro-ng/agent-listings`	`slug`+2 optional	1 credit
GET`/v1/propertypro-ng/agents`	none+2 optional	1 credit
GET`/v1/propertypro-ng/autocomplete`	`query`+1 optional	1 credit
GET`/v1/propertypro-ng/facets`	none	1 credit
GET`/v1/propertypro-ng/listing`	none+3 optional	1 credit
GET`/v1/propertypro-ng/search`	none+8 optional	1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

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 Read the docs