ParseForge
India Postal PIN Code Scraper
parseforge/india-postal-pincode-scraper
Developer toolsBusinessAutomation
Scrapes Indian post office details by 6-digit PIN code or branch name. Returns each match as a flat row with office name, district, state, circle, and delivery status.
- Total users
- 2
- Monthly active
- 0
- Total runs
- 107
- Bookmarked
- 1
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
India Postal PIN Code Scraper
Scrape Indian post office details by PIN code or branch name, up to a million per run. Every record returns the office name, district, state, and delivery status. No API key or registration. Export to CSV, JSON, Excel, or XML.
India Post's official PIN code directory is spread across multiple state circles and lacks a unified public API. This Actor queries the national postal database directly, accepting a list of 6-digit PIN codes or branch names, and returns the matching post office records in one flat schema. It handles the lookup logic so you get clean, structured data for logistics, verification, or market mapping.
| Who uses it | What they scrape India Post for |
|---|---|
| E-commerce logistics managers | Validating delivery serviceability for a list of customer PIN codes. |
| Address verification services | Building a lookup table to auto-fill city and state from a given PIN code. |
| Market researchers | Mapping the geographic distribution of post offices across Indian states and districts. |
| Data enrichment teams | Appending official postal region and circle data to existing address databases. |
What it does
This Actor collects Indian post office details by 6-digit PIN code or branch name and returns each match as a flat row.
- 📍 By PIN code: Provide a list of 6-digit PIN codes and get the corresponding post office details.
- 🏢 By branch name: Provide a list of post office branch names and retrieve their official records.
- 📊 Structured output: Every result includes the office name, district, state, circle, and delivery status in a consistent schema.
- ⚙️ Configurable limit: Set a maximum number of pincodes to collect per run, from 1 up to 1,000,000.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with India Post data
📦 Validate delivery coverage.
An e-commerce logistics team uploads a list of customer PIN codes to check which post offices serve those areas before committing to delivery timelines.
🗺️ Map post office density.
A market researcher runs a batch of PIN codes across a state to visualize the distribution of branch offices and delivery post offices.
🔎 Enrich address records.
A data enrichment team matches branch names from a legacy database to official India Post records to standardize district and state fields.
🏢 Verify branch details.
A compliance officer looks up specific branch names to confirm their official circle, region, and delivery status for a regulatory filing.
Why choose this scraper
| What you get | |
|---|---|
| No official API needed | Queries the India Post database without any registration or API key. |
| Bulk lookups | Process thousands of PIN codes or branch names in a single run. |
| Clean, flat schema | Every record is a flat row with office name, district, state, circle, and delivery status. |
| Flexible export | Download results as CSV, JSON, Excel, or XML for direct use in your systems. |
How it compares
This Actor focuses exclusively on India Post PIN code and branch name lookups, while the competitors below target different Indian government databases for company, tax, or marketplace data.
| Feature | ParseForge | India MCA Company Data Scraper | Gstin-scraper | IndiaMart Scraper |
|---|---|---|---|---|
| PIN code lookup | Yes | Not listed | Not listed | Not listed |
| Post office branch name search | Yes | Not listed | Not listed | Not listed |
| Returns district and state | Yes | Not listed | Not listed | Not listed |
| Returns delivery status | Yes | Not listed | Not listed | Not listed |
| No API key required | Yes | Not listed | Not listed | Not listed |
Configure the run
Drive the Actor from a list of 6-digit PIN codes or post office branch names, and set a maximum item limit to control the run size. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10,
"mode": "pincode",
"pincodes": [
"110001",
"400001",
"560001"
]
}
A larger pull:
{
"maxItems": 200,
"mode": "pincode",
"pincodes": [
"110001",
"400001",
"560001"
]
}
Pricing
Pay-per-result: $0.01333 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $1.33 |
| 1,000 results | $13.33 |
| 10,000 results | $133.30 |
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 to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the India Postal PIN Code Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to India Post through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/india-postal-pincode-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results for my PIN codes?
Check that you are using valid 6-digit Indian PIN codes. Also verify that you selected the correct mode ('By PIN code') in the input settings.
The Actor returns fewer results than the number of PIN codes I entered.
Some PIN codes may not have a matching record in the database, or you may have hit the maximum items limit. Increase the limit and re-run.
I switched to branch name mode but the Actor still looks up PIN codes.
Ensure you are populating the 'Branch Names' field, not the 'PIN Codes' field. The input section changes based on the selected mode.
The run takes too long for a large list.
The Actor processes requests sequentially. For very large lists, consider splitting them into multiple runs or increasing the run timeout in your Apify settings.
The output is missing the district or state for some entries.
This can happen if the India Post database has incomplete records for certain branch offices. Try looking up the same office by its PIN code instead.
FAQ
| Question | Answer |
|---|---|
| What data does this Actor return for each PIN code? | It returns the post office name, district, state, circle, region, and delivery status. The exact fields are shown in the sample output on the Actor's page. |
| Can I look up multiple PIN codes in one run? | Yes. Provide an array of 6-digit PIN codes in the input, and the Actor will process each one sequentially up to the maximum items limit you set. |
| Does this Actor support searching by post office branch name? | Yes. Switch the mode to 'By post office branch name' and provide a list of branch names. The Actor will return the matching official records. |
| Is there a limit on how many PIN codes I can scrape? | You can set the maximum items limit up to 1,000,000 per run. The Actor will stop once it reaches that count. |
| Do I need an API key from India Post? | No. This Actor queries the public India Post database directly. No registration or API key is required. |
| What output formats are supported? | You can export the results in CSV, JSON, Excel, or XML from the Apify dataset. |
| Can I use this to validate if a PIN code is deliverable? | The Actor returns the delivery status field for each post office, which indicates whether it is a delivery office. This helps assess serviceability. |
| Does it return the office address or the name? | It returns the office name, district, state, circle, and region. The full street address is not included in the standard output. |
| What happens if I enter an invalid PIN code? | The Actor will attempt the lookup and return an empty result or an error for that specific PIN code, then continue with the next one in your list. |
| Is this Actor suitable for real-time address verification? | It is designed for batch lookups. For real-time verification, you can integrate the Actor's API into your application and trigger runs programmatically. |
Related actors
Browse the full ParseForge collection 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 India Post. 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.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | Maximum number of pincodes to collect per run. | 10 |
| mode required | string (2 options) | Lookup mode. | pincode |
| pincodes | array | List of 6-digit Indian PIN codes. Used when mode is 'pincode'. Example: ['110001','400001','560001']. | ["110001","400001","560001"] |
| branchNames | array | List of post office branch names. Used when mode is 'postoffice'. Example: ['Connaught Place','Bandra']. | not set |
Pricing
from $10.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Result Item | Charged once per result collected. | $0.01 to $0.01333 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~india-postal-pincode-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.