Chercher des marchés publics | Documentation Prescriptio

POST /api/mcp/v1/marches.search, portée mcp:read; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil marches_rechercher.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/marches.search \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"avec_dce":true,"limit":20,"localisation":{"dept":"69"},"query":"isolation","sort":"deadline","type":"ouvert"}'

{
  "avec_dce": true,
  "limit": 20,
  "localisation": {
    "dept": "69"
  },
  "query": "isolation",
  "sort": "deadline",
  "type": "ouvert"
}

Réponsegénérée depuis le schéma

{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {
        "acheteur": "<texte>",
        "codes_cpv": [
          "<texte>"
        ],
        "date_attribution": "<texte>",
        "date_limite": "<texte>",
        "date_publication": "<texte>",
        "dce_consultable": false,
        "dept": "<texte>",
        "duree_mois": 0,
        "id_boamp": "<texte>",
        "jours_avant_cloture": 0,
        "montant_attribution": 0,
        "montant_estime_max": 0,
        "nature": "<texte>",
        "statut": "<texte>",
        "titulaire": "<texte>",
        "type_marche": "<texte>",
        "url": "<texte>",
        "url_avis": "<texte>",
        "ville": "<texte>"
      },
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}

Paramètres du corps

avec_dcebooléen

true = uniquement les marchés dont le dossier (DCE) est consultable dans Prescriptio via marches_dce : pas le lien externe plateforme acheteur. Chaque résultat porte fields.dce_consultable.

cloture_dans_joursentier

Date limite dans les N prochains jours (7 = ferment cette semaine). Combiner avec sort:"deadline". (min 0, max 3650)

cursortexte

Curseur next_cursor de la page précédente, repassé tel quel.

limitentier

(min 1, max 50, défaut 20)

localisationobjet

Zone géographique, une granularité. National = omettre (jamais dept:"all").

Voir les propriétés

communetexte

Nom de la commune de l'acheteur.

depttexte

Code département : 01-95, 2A/2B ou 971-978 (ex : "69").

regiontexte

Nom de région (ex : Auvergne-Rhone-Alpes, paca), couvre tous ses départements en un appel.

publie_depuis_joursentier

Publiés dans les N derniers jours (1 = veille du jour). Combiner avec sort:"recent". (min 0, max 3650)

querytexte

Recherche plein texte (titre, objet, acheteur, CPV). Une requête = un sujet : le plein texte exige tous les mots. Optionnelle si un filtre date/zone/type est fourni.

sorttexte

Deadline = ferme le plus tot d'abord ; recent = publié le plus récemment d'abord ; pertinence (défaut avec query). (valeurs : deadline · recent · pertinence)

typetexte

Ouvert = encore en consultation (une offre peut etre déposée) ; ferme = cloture ou attribue. Omis = les deux. (valeurs : ouvert · ferme)

En bref

Adresse: POST /api/mcp/v1/marches.search
Contrat: 3.0.0
Portée OAuth: mcp:read
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Outil MCP: marches_rechercher : même traitement

Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite marches.search.

Les marchés publicsDocumentation, Les données Moteur de rechercheDocumentation, Les modules Appels d'offresDocumentation, Les modules API RESTIA, Intégrations OpenAPIRéférence, Pour commencer

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse marches_rechercherLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

curl -sS https://prescriptio.fr/api/mcp/v1/marches.search \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"avec_dce":true,"limit":20,"localisation":{"dept":"69"},"query":"isolation","sort":"deadline","type":"ouvert"}'

{ "_meta": {}, "next_cursor": "<texte>", "results": [ { "fields": { "acheteur": "<texte>", "codes_cpv": [ "<texte>" ], "date_attribution": "<texte>", "date_limite": "<texte>", "date_publication": "<texte>", "dce_consultable": false, "dept": "<texte>", "duree_mois": 0, "id_boamp": "<texte>", "jours_avant_cloture": 0, "montant_attribution": 0, "montant_estime_max": 0, "nature": "<texte>", "statut": "<texte>", "titulaire": "<texte>", "type_marche": "<texte>", "url": "<texte>", "url_avis": "<texte>", "ville": "<texte>" }, "id": "<texte>", "resume": "<texte>", "titre": "<texte>" } ], "total_estimated": 0 }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Chercher des marchés publics L'opération REST marches.search de Prescriptio sert à rechercher les avis de marchés publics du bâti. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/marches.search \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"avec_dce":true,"limit":20,"localisation":{"dept":"69"},"query":"isolation","sort":"deadline","type":"ouvert"}' ``` **Corps JSON** ```json { "avec_dce": true, "limit": 20, "localisation": { "dept": "69" }, "query": "isolation", "sort": "deadline", "type": "ouvert" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "_meta": {}, "next_cursor": "<texte>", "results": [ { "fields": { "acheteur": "<texte>", "codes_cpv": [ "<texte>" ], "date_attribution": "<texte>", "date_limite": "<texte>", "date_publication": "<texte>", "dce_consultable": false, "dept": "<texte>", "duree_mois": 0, "id_boamp": "<texte>", "jours_avant_cloture": 0, "montant_attribution": 0, "montant_estime_max": 0, "nature": "<texte>", "statut": "<texte>", "titulaire": "<texte>", "type_marche": "<texte>", "url": "<texte>", "url_avis": "<texte>", "ville": "<texte>" }, "id": "<texte>", "resume": "<texte>", "titre": "<texte>" } ], "total_estimated": 0 } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `avec_dce` | booléen | — | true = uniquement les marchés dont le DOSSIER (DCE) est consultable DANS Prescriptio via marches_dce — pas le lien externe plateforme acheteur. Chaque résultat porte fields.dce_consultable. | | `cloture_dans_jours` | entier | — | Date limite dans les N prochains jours (7 = ferment cette semaine). Combiner avec sort:"deadline". (min 0, max 3650) | | `cursor` | texte | — | Curseur next_cursor de la page précédente, repassé tel quel. | | `limit` | entier | — | (min 1, max 50, défaut `20`) | | `localisation` | objet | — | Zone géographique, UNE granularité. National = omettre (jamais dept:"all"). | | `localisation.commune` | texte | — | Nom de la commune de l'ACHETEUR. | | `localisation.dept` | texte | — | Code département : 01-95, 2A/2B ou 971-978 (ex : "69"). | | `localisation.region` | texte | — | Nom de région (ex : Auvergne-Rhone-Alpes, PACA) — couvre tous ses départements en un appel. | | `publie_depuis_jours` | entier | — | Publiés dans les N derniers jours (1 = veille du jour). Combiner avec sort:"recent". (min 0, max 3650) | | `query` | texte | — | Recherche plein texte (titre, objet, acheteur, CPV). UNE requête = UN sujet : le plein texte exige TOUS les mots. Optionnelle si un filtre date/zone/type est fourni. | | `sort` | texte | — | deadline = ferme le plus tot d'abord ; recent = publié le plus récemment d'abord ; pertinence (défaut avec query). (valeurs : `deadline` · `recent` · `pertinence`) | | `type` | texte | — | ouvert = encore en consultation (une offre peut etre déposée) ; ferme = cloture ou attribue. Omis = les deux. (valeurs : `ouvert` · `ferme`) | ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/marches.search` | | Contrat | 3.0.0 | | Portée OAuth | `mcp:read` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Outil MCP | [`marches_rechercher`](https://prescriptio.fr/docs/api/marches_rechercher) : même traitement | ## Erreurs et quotas Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée. Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `marches.search`. - [Les marchés publics](https://prescriptio.fr/docs/donnees/marches-publics) : Documentation, Les données - [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules - [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules - [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations - [OpenAPI](https://prescriptio.fr/docs/reference/openapi) : Référence, Pour commencer ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [marches_rechercher](https://prescriptio.fr/docs/api/marches_rechercher) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations