# French Schools – IPS, Exam Results & Value Added by Address (`yck69/french-schools`) Actor

Every French primary school, collège and lycée around an address or in a commune: social position index (IPS), brevet and bac pass rates with value added, priority-education status, sections, contacts and map. Compare schools before moving, buying or opening a business.

- **URL**: https://apify.com/yck69/french-schools.md
- **Developed by:** [yck](https://apify.com/yck69) (community)
- **Categories:** Real estate, Education
- **Features:** Limited permissions
- **Stats:** 13 total users, 12 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $3.00 / 1,000 schools

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## French Schools – IPS, Exam Results & Value Added by Address

https://www.youtube.com/watch?v=UWatO8E4aqs

**What does French Schools do?** It lists every **primary school, collège and lycée** around an address (or in a commune or department) from the French Ministry of Education's open data, with the indicators families and property professionals actually look at: the **social position index (IPS)**, **brevet and bac pass rates**, the school's **value added**, priority-education status, sections, contacts and a map link.

- **Around any address**: nearest first, with distance — or every school of a commune or department.
- **IPS** (indice de position sociale): the official measure of pupils' family background, with the department and national averages for primary schools, and a plain label from *very disadvantaged* to *very advantaged*.
- **Results** for collèges (brevet, session 2025): pass rate, written-exam average, honours, and **value added** (how the school does compared with schools of similar intake). For lycées (bac): pass rate, honours rate, access rate from seconde to bac, with value added.
- **Practical facts**: public or private (and contract type), REP / REP+, canteen, boarding, ULIS, SEGPA, European/international/sport/arts sections, general/technological/vocational tracks, phone, email, website, ONISEP page.
- **Sort** by distance, IPS or value added; filter by type, sector or priority education.

Useful for parents and relocating families, real-estate agents and property listings, investors comparing neighbourhoods, and edtech or tutoring businesses targeting schools.

### What data can you get?

<table>
<tr><td>🏫 Name and type</td><td>🏛️ Public or private</td><td>📍 Address and distance</td></tr>
<tr><td>📞 Phone and email</td><td>📊 IPS social index</td><td>🎓 Brevet results</td></tr>
<tr><td>🎓 Bac results</td><td>➕ Value added</td><td>🎯 REP and REP+</td></tr>
<tr><td>🍽️ Canteen and boarding</td><td>🌍 Sections</td><td>🗺️ Map link</td></tr>
</table>

### How to use it

1. Click **Try for free** and open the Actor.
2. Enter an **address** and a radius, or communes.
3. Choose school types and sector.
4. Click **Start** and sort by distance or value added.
5. Export the list or attach it to a property listing.

### Input examples

**Every school within 1 km of an address**

```json
{
  "address": "18 rue de la République, 69002 Lyon",
  "radiusKm": 1
}
```

**Collèges and lycées of Villeurbanne, best value added first**

```json
{
  "communes": ["Villeurbanne"],
  "schoolTypes": ["college", "lycee"],
  "sortBy": "results"
}
```

**All private lycées in Gironde**

```json
{
  "departments": ["33"],
  "schoolTypes": ["lycee"],
  "sector": "private",
  "maxResults": 500
}
```

### Output

Real row from the first example (November 2026):

```json
{
  "uai": "0692693C",
  "name": "Collège Ampère",
  "type": "Collège",
  "sector": "Public",
  "address": "31 rue de la Bourse, 69289, Lyon",
  "distanceKm": 0.17,
  "phone": "04 72 10 12 12",
  "email": "ce.0692693C@ac-lyon.fr",
  "educationPriority": null,
  "canteen": true,
  "ips": 121.7,
  "ipsLevel": "advantaged",
  "ipsYear": "2022-2023",
  "students": 495,
  "results": {
    "exam": "Diplôme national du brevet",
    "session": "2025",
    "candidates": 112,
    "passRatePercent": 92,
    "passRateValueAdded": -3,
    "writtenAverage": 13.2,
    "writtenValueAdded": 0.3,
    "honoursRatePercent": 80.4,
    "stayRate6eTo3ePercent": 88
  }
}
```

The same run found 39 schools within 1 km, such as *Ecole primaire Lamartine* (IPS 130.1 in 2024-2025, against 112.2 for the Rhône and 105.8 nationally). The Villeurbanne example puts REP+ *Collège Lamartine* first: IPS 74.5, yet a brevet pass rate **14 points above** what its intake predicts.

| Field | Meaning |
|---|---|
| `ips` | Social position index of the pupils' families (national average around 105). Higher = more advantaged background. |
| `passRateValueAdded` | Pass rate minus the rate expected for a school with the same pupils (age, background). Positive = the school adds value. |
| `educationPriority` | `REP` or `REP+` for schools in priority-education networks. |
| `multiSite` | The school (same UAI) has several sites, each listed with its own address. |

### How much does it cost?

**$3 per 1,000 schools** ($0.003 per school returned). A neighbourhood search typically returns 20–60 schools, for under $0.20.

### More Actors from this developer

### FAQ

##### Where does the data come from?

From the Ministry of Education's open data: the *annuaire de l'éducation* (updated daily), IPS by school, and the *indicateurs de valeur ajoutée* of collèges and lycées. The latest published year is used for each indicator (`ipsYear`, `results.session`).

##### Why do some schools have no IPS or results?

Private schools outside state contracts, very small schools and some special establishments are not published. Primary schools have an IPS but no exam results; vocational lycées don't have general bac results.

##### Is a high IPS a "better" school?

No. IPS describes families' background; value added shows how well a school does with its pupils. Read both together.

##### Can I use it through the API, Make, Zapier or Google Sheets?

Yes. Every run can be started and read through the [Apify API](https://docs.apify.com/api/v2) (JavaScript and Python clients, CLI, MCP), and Apify integrations connect it to Make, Zapier, n8n, Google Sheets, Slack, webhooks and more.

##### Is it legal to use this data?

The Actor only reads public or official open data and doesn't log in anywhere. Check the source's licence and your local rules (for example GDPR when data concerns people) for your use case; if in doubt, ask a lawyer.

##### Something isn't working, or you need another field?

Open an issue on the **Issues** tab: feedback is read and answered.

# Actor input Schema

## `address` (type: `string`):

Schools around this address, nearest first.

## `radiusKm` (type: `number`):

Around the address.

## `communes` (type: `array`):

Names or postal codes, used when no address is given. Paris, Lyon and Marseille include all arrondissements.

## `departments` (type: `array`):

Department codes, e.g. <code>69</code>, <code>2A</code>.

## `schoolTypes` (type: `array`):

Primary schools (maternelle and élémentaire), collèges (11–15) and lycées (15–18).

## `sector` (type: `string`):

Public, private or both.

## `educationPriorityOnly` (type: `boolean`):

Keep schools in the éducation prioritaire networks.

## `includeAnnexes` (type: `boolean`):

Also list SEGPA, SEP and other sections attached to a main school.

## `sortBy` (type: `string`):

Nearest first by default when an address is given.

## `maxResults` (type: `integer`):

Stops after this many schools.

## Actor input object example

```json
{
  "address": "18 rue de la République, 69002 Lyon",
  "radiusKm": 1,
  "schoolTypes": [
    "ecole",
    "college",
    "lycee"
  ],
  "sector": "all",
  "educationPriorityOnly": false,
  "includeAnnexes": false,
  "maxResults": 100
}
```

# Actor output Schema

## `schools` (type: `string`):

Type, sector, IPS and results per school.

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

Every field of every row.

# 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 = {
    "address": "18 rue de la République, 69002 Lyon",
    "radiusKm": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("yck69/french-schools").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 = {
    "address": "18 rue de la République, 69002 Lyon",
    "radiusKm": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("yck69/french-schools").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 '{
  "address": "18 rue de la République, 69002 Lyon",
  "radiusKm": 1
}' |
apify call yck69/french-schools --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,yck69/french-schools"
        }
    }
}
```

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/4bGc1KNJOdQl7cM0l/builds/nzcRzAw5ew3rdQNBR/openapi.json
