{
  "@context": "https://agenticresourcediscovery.org/context/v1",
  "publisher": "https://www.gites-finistere.com",
  "name": "Gîtes de France® Finistère",
  "description": "Site officiel des Gîtes de France® Finistère (Bretagne, France) : réservation de plus de 2300 hébergements de vacances agréés — gîtes, chambres d'hôtes, gîtes d'étape et de groupe, city breaks, campings et chalets loisirs.",
  "version": "1.0.0",
  "updatedAt": "2026-11-13",
  "entries": [
    {
      "@context": "https://agenticresourcediscovery.org/context/v1",
      "identifier": "urn:air:gites-finistere.com:search:hebergements",
      "displayName": "Moteur de recherche d'hébergements — Gîtes de France Finistère",
      "type": "application/agent-card+json",
      "description": "Recherche parmi plus de 2300 hébergements agréés Gîtes de France® dans le Finistère : par commune, référence (ex. 29G123456) ou nom, avec filtres de dates d'arrivée/départ, capacité, catégorie, équipements, thématiques, distance à la mer et promotions. Résultats paginés (30 par page).",
      "capabilities": ["HebergementSearch", "CommuneFilter", "DateAvailabilityFilter", "CapacityFilter", "TypeFilter", "EquipmentFilter", "ThemeFilter", "SeaDistanceFilter", "PromoFilter", "Pagination"],
      "tags": ["vacances", "location-saisonniere", "gites", "chambres-hotes", "finistere", "bretagne", "france", "reservation", "tourisme"],
      "representativeQueries": [
        "trouver un gîte à Concarneau pour 4 personnes du 12 au 19 juillet 2026",
        "chambre d'hôtes près de Quimper avec vue sur mer",
        "location de vacances avec piscine chauffée acceptant les animaux dans la presqu'île de Crozon",
        "gîte de groupe pour 20 personnes dans le nord Finistère",
        "gîte avec internet et télétravail disponible cet hiver"
      ],
      "data": {
        "endpoint": "https://www.gites-finistere.com/location-vacances/",
        "method": "GET",
        "responseFormat": "text/html",
        "parameters": {
          "q": "Commune (nom ou slug), référence d'hébergement (ex. 29G123456) ou nom — une référence exacte redirige vers la fiche de l'hébergement",
          "commune": "Alias de q pour la commune uniquement",
          "arrival": "Date d'arrivée, format JJ/MM/AAAA (ex. 12/07/2026)",
          "departure": "Date de départ, format JJ/MM/AAAA",
          "periode": "Période flexible alternative à arrival+departure, format JJ/MM/AAAA-JJ/MM/AAAA",
          "capacite[adulte]": "Nombre d'adultes (18 ans et plus)",
          "capacite[enfant]": "Nombre d'enfants (2 à 17 ans)",
          "capacite[bebe]": "Nombre de bébés (moins de 2 ans, non comptés dans la capacité)",
          "chambre": "Nombre minimal de chambres (entier)",
          "type[]": "Catégorie d'hébergement, répétable : g (gîte), h (chambre d'hôtes), ge (gîte d'étape / de groupe)",
          "crit[<slug>]": "Critère d'équipement ou de label, ex. crit[piscine-sur-place], crit[219] (piscine chauffée), crit[lave-vaisselle], crit[c-vue-sur-mer], crit[tourisme-et-handicap], crit[acces-internet], crit[table-dhote]",
          "rub[]": "Rubrique : MAIS (maison), APPT (appartement), ANIMO (animal accepté), MENAI (ménage inclus), TELTR (télétravail), PPRIV (piscine privée), PCOMU (piscine commune), SAUNA, ECOGE (écogestes), BIODI (biodiversité), FDMOM-VILLE (city break), TRO25 (trophées clients)",
          "loisir[mer]": "Distance maximale à la mer en km : 0-1, 0-10, 0-20, 20-80",
          "distance": "Rayon de recherche autour de la commune, en km (1 à 100, défaut 30)",
          "distancetype": "Mode de calcul de la distance : radial | route",
          "promo": "Sans valeur — uniquement les hébergements en promotion",
          "nouveaux": "Sans valeur — uniquement les nouveautés",
          "tri": "Tri des résultats : dateOuverture.asc | random",
          "pge": "Numéro de page (30 résultats par page)"
        },
        "examples": [
          "https://www.gites-finistere.com/location-vacances/?q=concarneau&arrival=12/07/2026&departure=19/07/2026&capacite%5Badulte%5D=2",
          "https://www.gites-finistere.com/location-vacances/?q=quimper&type%5B%5D=h&loisir%5Bmer%5D=0-10&promo",
          "https://www.gites-finistere.com/location-vacances/?q=crozon&distance=50&crit%5Bpiscine-sur-place%5D=&rub%5B%5D=ANIMO&pge=2"
        ]
      }
    },
    {
      "@context": "https://agenticresourcediscovery.org/context/v1",
      "identifier": "urn:air:gites-finistere.com:api:recherche-hebergements",
      "displayName": "API JSON de recherche d'hébergements — Gîtes de France Finistère",
      "type": "application/agent-card+json",
      "description": "API REST publique exposant le même moteur de recherche que la page /location-vacances/ au format JSON. Réponse : {\"status\":\"OK\",\"output\":[...]}. Accepte les mêmes paramètres de recherche (q, arrival, departure, periode, capacite, type, crit, rub, loisir, distance, promo, nouveaux, tri, pge).",
      "capabilities": ["HebergementSearch", "JsonResults", "CommuneFilter", "DateAvailabilityFilter", "CapacityFilter", "EquipmentFilter"],
      "tags": ["vacances", "api", "json", "gites", "finistere", "bretagne", "reservation"],
      "representativeQueries": [
        "récupérer en JSON les gîtes disponibles à Douarnenez du 1er au 8 août 2026",
        "liste JSON des chambres d'hôtes à moins de 10 km de la mer près de Brest",
        "rechercher la référence 29G123456 via l'API"
      ],
      "data": {
        "endpoint": "https://www.gites-finistere.com/wp-json/gites/v1/search",
        "method": "GET ou POST",
        "responseFormat": "application/json",
        "parameters": "Identiques à ceux du moteur de recherche web (voir urn:air:gites-finistere.com:search:hebergements)",
        "examples": [
          "https://www.gites-finistere.com/wp-json/gites/v1/search?q=concarneau&arrival=12/07/2026&departure=19/07/2026&capacite%5Badulte%5D=2"
        ]
      }
    },
    {
      "@context": "https://agenticresourcediscovery.org/context/v1",
      "identifier": "urn:air:gites-finistere.com:catalog:hebergements",
      "displayName": "Catalogue des hébergements par commune — Gîtes de France Finistère",
      "type": "text/html",
      "url": "https://www.gites-finistere.com/nos-gites-par-communes/",
      "description": "Catalogue consultable des hébergements agréés : index par commune (gîtes et chambres d'hôtes), pages de listing par commune avec filtres, et fiches détaillées (photos, capacités, équipements, tarifs, avis clients, planning de disponibilité). Fiches accessibles via /fiche/{REFERENCE}/ (ex. /fiche/29G123456/) ou /location-vacances/bretagne/{commune}/{slug}-{reference}/.",
      "capabilities": ["HebergementCatalog", "CommunePages", "ProductSheets", "AvailabilityCalendar", "CustomerReviews"],
      "tags": ["catalogue", "gites", "chambres-hotes", "finistere", "bretagne", "communes"],
      "representativeQueries": [
        "liste des gîtes à Saint-Pol-de-Léon",
        "fiche détaillée de l'hébergement 29G123456",
        "chambres d'hôtes disponibles à Camaret-sur-Mer"
      ]
    }
  ]
}