# SquareYards India Property Listings Scraper (`parseforge/squareyards-india-scraper`) Actor

Scrapes SquareYards India residential property listings by city and transaction type. Returns each listing as a flat row with price, BHK, area, and locality.

- **URL**: https://apify.com/parseforge/squareyards-india-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Real estate, Other
- **Stats:** 5 total users, 1 monthly users, 90.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### SquareYards India Property Listings Scraper

**Scrape residential property listings from SquareYards India by city and transaction type, up to a million per run.** Every listing returns its price, BHK configuration, area, locality, and property details. No login or API key. Export to CSV, JSON, Excel, or XML.

SquareYards lists thousands of Indian residential properties for sale and rent, but manually copying listings for market analysis or lead generation is slow and error-prone. This actor reads the public search pages directly, filtering by city slug and transaction type, and returns each matching property in a consistent flat schema. It works for Mumbai, Bangalore, Delhi NCR, and every other city SquareYards covers.

| Who uses it | What they scrape SquareYards India for |
|---|---|
| Real estate investors | Monitor asking prices and available inventory in a target city. |
| Property portals | Aggregate fresh listings from SquareYards to populate their own search index. |
| Data analysts | Build price trend datasets across BHK configurations and localities. |
| Marketing agencies | Source property leads and contact details for developer campaigns. |

### What it does

This Actor collects SquareYards India property listings by city and sale or rent filter, and returns each one as a flat row.

- 🏙️ **City filter:** drive the scrape with a city slug like mumbai, bangalore, or delhi-ncr.
- 💰 **Transaction type:** choose sale or rent to match the exact listing pool you need.
- 🔢 **Volume control:** set a hard cap on the number of properties collected per run, from 1 to 1,000,000.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with SquareYards India data

**📈 Track city price trends.**

A data analyst runs the scraper weekly for the mumbai slug with the sale filter to feed a price-per-square-foot dashboard.

**🏠 Build a rental inventory feed.**

A property portal operator scrapes bangalore rent listings daily to keep their site fresh with SquareYards sourced flats.

**📊 Compare BHK configuration demand.**

A market researcher collects sale listings across delhi-ncr and groups them by BHK to see which configuration moves fastest.

**📋 Generate developer lead lists.**

A marketing agency scrapes sale listings in pune to extract project names and contact details for outreach campaigns.

### Why choose this scraper

| | What you get |
|---|---|
| **City-level search** | Target one Indian city per run using its SquareYards URL slug. |
| **Sale or rent** | Switch between buying and rental markets with a single dropdown. |
| **Flat output** | Every listing lands in your dataset as one row, ready for analysis. |

### How it compares

This actor focuses on simple city-level search with a clean flat output, while other SquareYards scrapers offer deeper filters like locality, property ID, or new project pages.

| Feature | ParseForge | SquareYards Scraper | Square Yards Scraper - India Property Listings & Prices | Square Yards Scraper - India Property Listings & Prices |
|---|---|---|---|---|
| City-level search | Yes, via city slug | Yes | Yes | Yes |
| Sale and rent filter | Yes, dropdown select | Yes | Not listed | Not listed |
| Locality or ID search | Not listed | Yes | Not listed | Not listed |
| New project pages | Not listed | Yes | Not listed | Yes |
| GPS coordinates | Not listed | Not listed | Yes | Yes |
| Flat row output | Yes | Not listed | Not listed | Not listed |

### Configure the run

Drive the Actor with a SquareYards city slug and a transaction type, and set a maximum number of properties to cap the run. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10
}
```

A larger pull:

```json
{
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.021 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [SquareYards India Property Listings Scraper](https://apify.com/parseforge/squareyards-india-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to SquareYards India through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/squareyards-india-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that the city slug exactly matches a SquareYards URL segment. For example, delhi-ncr works, but delhi alone may not. Also verify that the transaction type you selected has listings on the site for that city.

**The run stops before reaching my maxItems limit.**

SquareYards may not have as many listings as your maxItems value for that city and transaction type. The actor stops when it runs out of pages. Try a larger city or switch from rent to sale, which usually has more inventory.

**Some property fields are empty in the output.**

SquareYards listings do not always fill every field. If a developer or a floor number is not on the page, that cell will be blank. This is expected and reflects the source data.

**I get an error about the city slug.**

The city slug must be lowercase and match the SquareYards URL pattern. Go to squareyards.com, navigate to a city, and copy the slug from the address bar. Avoid trailing slashes or spaces.

### FAQ

| Question | Answer |
|---|---|
| What is a city slug and where do I find it? | A city slug is the part of the SquareYards URL that identifies the city, like mumbai or bangalore. Look at the SquareYards website URL when you browse a city, and copy the word after /property-for-sale-in- or /property-for-rent-in-. |
| Does this scraper get contact details for the agent or developer? | The actor returns whatever contact information SquareYards displays on the public listing page. If a phone number or developer name is visible in the listing, it will appear in your output row. |
| Can I scrape multiple cities in one run? | The input accepts one city slug per run. To scrape multiple cities, run the actor once per city, either manually or by scheduling separate tasks. |
| How do I get only rental listings? | Set the Transaction Type input to rent. The actor will then only collect listings from the rental section of SquareYards for your chosen city. |
| What format does the data come in? | The default dataset is JSON. You can export it to CSV, Excel, or XML from the Apify dataset tab after the run finishes. |
| Is there a risk of getting blocked by SquareYards? | The actor uses standard web scraping techniques and reads public pages. Running it at moderate speeds with reasonable maxItems values reduces the chance of any interruption. |
| Can I scrape new project listings, not resale? | The actor targets the main property search pages for sale and rent. If SquareYards lists new projects on those same result pages, they will be included. Dedicated new project pages are not a separate input mode. |
| Does the actor handle pagination automatically? | Yes, it follows the search result pages until it reaches your maxItems limit or runs out of listings. |
| What cities are supported? | Any city that SquareYards has a dedicated page for. Common ones include mumbai, bangalore, delhi-ncr, pune, hyderabad, chennai, and kolkata. Check the SquareYards site for the exact slug. |
| Can I set a price range filter? | The input schema does not include a price range filter. The actor collects all listings for the city and transaction type, up to your maxItems cap. You can filter by price after export in your spreadsheet or database. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Square Yards Consulting Private Limited. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `maxItems` (type: `integer`):

How many properties to collect per run.

## `city` (type: `string`):

City slug e.g. mumbai, bangalore, delhi-ncr.

## `transactionType` (type: `string`):

Transaction Type

## Actor input object example

```json
{
  "maxItems": 10,
  "city": "mumbai",
  "transactionType": "sale"
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by SquareYards India Property Listings Scraper.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/squareyards-india-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/squareyards-india-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call parseforge/squareyards-india-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/squareyards-india-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cxuH460IXjfEHc25b/builds/bloVAHb9QlGeqSqYZ/openapi.json