France Postal Code Search

Get location data including commune name and INSEE code from French postal codes.

Simply provide a list of postal codes and get back structured location data for each one.

No login required. No cookies needed. Pay-per-event pricing.

Why Choose This Actor?

"Enrich your data with French location information in seconds"

Our France Postal Code Search provides:

• Very Fast Responses: Parallel processing for large batches
• Cost-Effective: Pay only for the rows you get back: $2.00 / 1k rows (one postal code can return several rows)
• Complete Data: Get commune name, INSEE code, routing label, and complement

Quick Start

1. Open the actor on Apify and go to the Input tab.
2. Paste the example input below (or edit the prefilled list).
3. Click Start and wait for the run to finish.
4. Open the Output (dataset) tab to view or export the results as JSON, CSV or Excel.

{
  "postalcodes": ["75001"]
}

Example output item:

{
  "postalcode": "75001",
  "commune_insee_code": "75101",
  "commune_name": "PARIS 01",
  "routing_label": "PARIS",
  "complement": "",
  "error": null
}

Usage Examples

Resolve a Single Postal Code

{
  "postalcodes": ["75001"]
}

Resolve Multiple Postal Codes

{
  "postalcodes": ["75001", "13001", "69001"]
}

Returns one row per commune/locality (a single postal code can return many rows). Example row:

{
  "postalcode": "75001",
  "commune_insee_code": "75101",
  "commune_name": "PARIS 01",
  "routing_label": "PARIS",
  "complement": "",
  "error": null
}

Input Parameters

Parameter	Type	Required	Default	Description
postalcodes	array	Yes	-	List of French postal codes (zip codes) to resolve (5 digits each). 1-1000 per run; duplicates are ignored, invalid or too many codes fail the run

Output Fields

Field	Type	Description
postalcode	string	5-digit French postal code
commune_insee_code	string	5-character INSEE commune code
commune_name	string	Commune name
routing_label	string	Delivery routing label (libellé d'acheminement), usually the commune name
complement	string	Additional address line for hamlets/localities (ligne 5), often empty
error	null/string	Error message if lookup failed

Free plan

Free-plan users get 5 runs in total. Each free run processes only the first 10 codes in your input (the rest is ignored without an error) and returns at most 10 results.

Pricing

Cost	Description
$0.0001 / start	Charged per actor run
$2.00 / 1,000 rows	Charged per row returned; one postal code can return multiple rows

API Integration

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("bite-sized-insights/france-zip-codes").call(
    run_input={
        "postalcodes": ["75001", "13001", "69001", "33000"]
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['postalcode']}: {item['commune_name']}")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('bite-sized-insights/france-zip-codes').call({
    postalcodes: ['75001', '13001', '69001']
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.postalcode}: ${item.commune_name}`);
});

Use Cases

• Data Enrichment: Add location data to customer records using postal codes or zip codes
• Address Validation: Verify French postal codes (zip codes) exist
• Geographic Analysis: Map postal codes to communes and INSEE codes
• Logistics: Determine delivery regions from postal codes

Going global?

Looking for postal code data in other countries? Check out our other actors:

• US ZIP Code Search - US ZIP codes (5-digit)
• Norway Postal Code Search - Norwegian postal codes (4-digit)
• India PIN Code Search - Indian PIN codes (6-digit)

Notes

• Postal codes (zip codes) must be provided as strings (e.g., "75001" not 75001)
• French postal codes are 5 digits, covering metropolitan France, overseas departments/territories, and Monaco
• A single postal code can map to multiple communes (e.g. rural areas sharing one postal code) — expect more than one result per code in some cases
• Invalid or non-existent postal codes will not appear in results
• Results are returned in no particular order
• Large requests are automatically split into batches and processed in parallel

---

Need help? Open an issue on the actor's repository or contact support through Apify Console.