Sign in Get API key
Urbania API

Urbania API for Peruvian Property Search, Listing Details, Agencies, and Locations

Scrappa's Urbania API returns structured JSON from Urbania, a large Peruvian property marketplace. Search apartments, houses, land, offices and shops for sale, rent or temporary rent, filter by place, price, bedrooms, bathrooms and area, sort by price, date or views, read full listing detail, resolve places with autocomplete and read agency profiles.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
4
Endpoints
3
Search operations
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&bedrooms_min=2&exclude_projects=true" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 151143469,
        "url": "https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-barrio-medico-miraflores-3-dormitorios-151143469",
        "operation": "sale",
        "prices": [
          { "currency": "PEN", "amount": 702000 },
          { "currency": "USD", "amount": 208000 }
        ],
        "bedrooms": 3,
        "bathrooms": 2,
        "area_covered": 104,
        "is_project": false
      }
    ],
    "page": 1,
    "per_page": 30,
    "total": 833,
    "has_more": true
  },
  "meta": { "endpoint_family": "search", "billable": true }
}

What you can build

Structured data for real applications. Here are some ideas.

Property Price Analysis

Read prices in soles and dollars, area and bedrooms to compare sale and rent listings across Lima and other cities.

Rental Search Tools

Filter rentals by price, bedrooms and property type and sort by price to build rental finders.

Listing Monitor

Watch one listing for price, status and photos.

Agency Research

Read agency profiles with their current listings.

Location Lookup

Resolve free text into district and zone slugs that plug into the search.

Urbania scraper API

Urbania API for Peruvian property search, listing detail, and agencies

The Urbania API is built for property analytics, rental tools and real-estate search features. Each listing carries prices in soles and dollars, area in square metres, bedrooms, bathrooms, parking, address, coordinates, photos and the advertiser. Filters are checked against the answer, so returned items match the filters you set.

Search sale, rent and temporary listings with place, type, price, bedroom, bathroom and area filters.

Sort by price, date, views or price drops and page through results; a page past the end returns an empty list.

Open any listing for the full description, amenities and every photo.

Read agency profiles with their current listings.

Place slugs come from autocomplete and plug straight into the search.

Choose the right Urbania API endpoint

Start with Autocomplete

Resolve a district or zone slug once, then reuse it as the location of the search.

Open Urbania Autocomplete API docs

Use Property Search for market coverage

Filter by operation, type, place, price, rooms and area to collect matching listings with live paging metadata.

Open Urbania Search API docs

Available endpoints

Everything you need in one API.

GET

Property Search

/api/urbania/search

Search sale, rent or temporary listings with place, type, price, room and area filters

Try in Playground View docs

Related resources

Square Yards API overview

Compare Indian property coverage with the Square Yards API.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

Urbania listing data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Filters checked against the answer
Scrappa:
ScrapingBee / ScraperAPI:
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Sale, rent and temporary search with place, type, price, bedroom, bathroom and area filters
Prices in soles and dollars with area in square metres
Price, date and view sorting and page numbers that always match the returned data
Full listing detail with amenities, coordinates and photos
Agency profiles with current listings

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Urbania. The API returns structured JSON from public listings through a Scrappa API key.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan.

Use the one-based page parameter. A page holds up to 30 listings. The response returns page, per_page, total and has_more, and a page past the end is a successful empty response.

Yes. Projects appear in every search without room counts and carry is_project true. Set exclude_projects to remove them.

Start using the Urbania API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation