# Mobilizon API
> Live data for Mobilizon, the federated events platform — the open-source ActivityPub alternative to Meetup, Eventbrite and Facebook Events — served straight from Mobilizon's public GraphQL API, no key, nothing cached. The events endpoint searches upcoming public events by keyword and returns each event's title, start and end time, the place (or whether it is online), the organiser, the number of people going, the tags and a link. The event endpoint returns one event in full, including its description. The groups endpoint searches the organising groups and returns each group's name, handle, instance domain, summary and member count. It reads the flagship mobilizon.fr instance, which federates events from across the Mobilizon network. This is the events-and-organisers layer for any community, calendar, social or local app — what is happening, where, and who is organising it. Live from Mobilizon, nothing stored. Distinct from corporate-events and centralised-platform APIs — this is federated grassroots events. 4 endpoints.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/mobilizon-api/..."
```

## Pricing
- **Free** (Free) — 14,500 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 172,000 calls/Mo, 8 req/s
- **Pro** ($15/Mo) — 718,000 calls/Mo, 15 req/s
- **Scale** ($36/Mo) — 3,580,000 calls/Mo, 30 req/s

## Endpoints

### Mobilizon

#### `GET /v1/event` — One event in full

**Parameters:**
- `uuid` (query, required, string) — Event uuid Example: `616dd97d-fb62-4300-bb97-222ca3848b1c`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mobilizon-api/v1/event?uuid=616dd97d-fb62-4300-bb97-222ca3848b1c"
```

**Response:**
```json
{
    "data": {
        "url": "https://mobilizon.fr/events/616dd97d-fb62-4300-bb97-222ca3848b1c",
        "tags": [],
        "uuid": "616dd97d-fb62-4300-bb97-222ca3848b1c",
        "title": "Rencontres Musicales Européennes",
        "online": false,
        "ends_on": "2026-08-08T22:00:00Z",
        "location": {
            "region": null,
            "country": null,
            "locality": null,
            "description": null
        },
        "begins_on": "2026-08-08T19:00:00Z",
        "organizer": null,
        "description": null,
        "participants": 0
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:49.703Z",
        "request_id": "bbd91025-d8fb-4493-9e36-70dadcc1eaf9"
    },
    "status": "ok",
    "message": "Event retrieved successfully",
    "success": true
}
```

#### `GET /v1/events` — Search public events

**Parameters:**
- `q` (query, required, string) — Search keyword Example: `climate`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mobilizon-api/v1/events?q=climate&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "climate",
        "total": 10,
        "events": [
            {
                "url": "https://mobilizon.fr/events/a8f86c6e-7789-40dc-828f-acc1a0dce1ce",
                "tags": [
                    "climat",
                    "écologie",
                    "environnement",
                    "éducation",
                    "carbone",
                    "orléans",
                    "gratuit"
                ],
                "uuid": "a8f86c6e-7789-40dc-828f-acc1a0dce1ce",
                "title": "La Fresque du Climat à Orléans",
                "online": false,
                "ends_on": "2026-07-04T11:00:00Z",
                "location": {
                    "region": "Loiret",
                    "country": "France",
                    "locality": "Orléans",
                    "description": "Muséum d'Orléans pour la Biodiversité et l'Environnement"
                },
                "begins_on": "2026-07-04T08:00:00Z",
                "organizer": null,
                "participants": 0
            },
            {
                "url": "https://mobilizon.fr/events/987e600c-45cc-4f84-940b-a11fce81969e",
                "tags": [
                    "Climat"
                ],
                "uuid": "987e600c-45cc-4f84-940b-a11fce81969e",
                "title": "Sabin.leclercq@gmail.com,offre de prêt entre particulier sérieux et honnête en 48H",
                "online": false,
          
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/groups` — Search organising groups

**Parameters:**
- `q` (query, required, string) — Search keyword Example: `climate`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mobilizon-api/v1/groups?q=climate&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 12,
        "query": "climate",
        "total": 12,
        "groups": [
            {
                "url": "https://mobilizon.fr/@climactif_en_gohelle62",
                "name": "Climactif en Gohelle",
                "domain": "mobilizon.fr",
                "handle": "climactif_en_gohelle62",
                "members": 1,
                "summary": "Collectif engagé sur le territoire de l'agglomération Lens-Liévin pour la protection de l'environnement. Nous nous intéressons aux questions liées au climat, à l'eau, au sol, à la biodiversité."
            },
            {
                "url": "https://mobilizon.fr/@capclimat_orleans",
                "name": "CAP Climat Orléans",
                "domain": "mobilizon.fr",
                "handle": "capclimat_orleans",
                "members": 6,
                "summary": "CAP Climat Orléans est une association qui organise des événements et des ateliers de vulgarisation et de sensibilisation aux enjeux climatiques et environnementaux. Nous comptons notamment parmi nos membres des animateurs La Fresque du Climat, La Fresque de la Biodiversité, 2 tonnes, Inventons Nos Vies Bas Carbone, La Fresque du Numérique, La Fresque du Sol, La Fresque des Limites Planétaires etc... Ecrivez-nous pour plus d'informations : contact@capclimatorleans.fr Pour rester informé.e de notre actualité, inscrivez-vous à notre newsletter et suivez-nous sur LinkedIn | Facebook | Instagram Adhére
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mobilizon-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Mobilizon public GraphQL API (live)",
        "service": "mobilizon-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/event": "One event in full with description (uuid=…).",
            "GET /v1/events": "Search public events by keyword (q=climate, limit up to 50).",
            "GET /v1/groups": "Search organising groups (q=climate): name, handle, members."
        },
        "description": "Live data for Mobilizon, the federated events platform (open ActivityPub alternative to Meetup/Eventbrite/Facebook Events): search upcoming public events by keyword (title, time, place or online, organiser, attendee count, tags, link); fetch one event in full with its description; and search the organising groups (name, handle, domain, summary, member count). Reads the flagship mobilizon.fr instance. Live, no key, nothing stored. Distinct from corporate-events and centralised-platform APIs — this is federated grassroots events.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:50.252Z",
        "request_id": "42f0689b-cb5e-4e81-83ec-e446d9152458"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/mobilizon-api
OpenAPI spec: https://www.oanor.com/api/mobilizon-api/openapi.json