API publique - gratuite

Intégrez l'agenda des sorties à votre site

Récupérez les événements d'un département, d'une région, d'une ville ou d'un organisateur (marchés, salons, brocantes, fêtes…) en JSON, pour les afficher comme vous voulez. Idéal pour les offices de tourisme, mairies, chambres des métiers, fédérations et organisateurs.

Sans clé

Données publiques, aucune authentification.

CORS ouvert

Appelable depuis n'importe quel site.

Mis en cache

Rapide et tenant la charge (CDN).

Endpoint

GET https://ousortir.me/api/public/events?dept=44

Exemples : ?dept=44&limit=20 · ?region=bretagne · ?ville=Guérande&dept=44 · ?orga=mon-slug · ?dept=44&open=1

Paramètres

Paramètre	Obligatoire	Description
dept	requis*	Code du département (ex. 44, 75, 2A). *au moins un filtre parmi dept, region, ville, orga.
region	requis*	Slug de région (ex. pays-de-la-loire, bretagne).
ville	requis*	Nom exact de la commune, accents compris (ex. Guérande). Combinable avec dept pour lever les homonymes.
orga	requis*	Slug de la page organisateur (le dernier segment de ousortir.me/organisateurs/…) : uniquement SES événements.
open	optionnel	open=1 : uniquement les événements qui recherchent des exposants.
limit	optionnel	Nombre d'événements (défaut 12, max 50).

Exemple (JavaScript)

fetch("https://ousortir.me/api/public/events?dept=44&limit=10")
  .then((r) => r.json())
  .then(({ events }) => {
    for (const e of events) {
      console.log(e.title, e.city, e.start_date, e.url)
    }
  })

Réponse

{
  "count": 2,
  "events": [
    {
      "id": "58197600-de13-4249-99a0-a8f0500bcb21",
      "title": "Le Temps des Copains 2026",
      "url": "https://ousortir.me/evenements/le-temps-des-copains-2026-…",
      "city": "Le Landreau",
      "region": "Pays de la Loire",
      "department": "44",
      "start_date": "2026-06-28T08:00:00+00:00",
      "end_date": "2026-06-29T21:00:00+00:00",
      "image": "https://ousortir.me/images/cat-marche-createurs.png",
      "free_entry": true,
      "applications_open": true
    }
  ]
}

Champ	Type	Description
id	string	Identifiant unique de l'événement.
title	string	Nom de l'événement.
url	string	Lien vers la fiche complète sur ousortir.me.
city	string \| null	Ville.
region	string \| null	Région.
department	string \| null	Code département.
start_date	string (ISO 8601)	Date/heure de début.
end_date	string \| null	Date/heure de fin.
image	string \| null	Image de l'événement.
free_entry	boolean	Entrée gratuite pour les visiteurs.
applications_open	boolean	Un exposant peut candidater en ligne.

Bon usage

Les réponses sont mises en cache ~10 min : inutile d'appeler l'API à chaque chargement de page.
Merci de conserver un lien vers la fiche (champ url) et idéalement une mention « Agenda propulsé par Ou Sortir ».
Données publiques, fournies telles quelles. Pour un volume important ou un besoin spécifique, contactez-nous.

Pas développeur ?

Pas besoin de coder : récupérez un widget « copier-coller » prêt à intégrer sur votre site.

Obtenir le widget Nous contacter