IA-Asso.fr Search API
The Search API from IA-Asso.fr — 2 operation(s) for search.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ia-asso-fr:ia-asso-fr-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: IA-Asso.fr Public Search API
version: 1.0.0
description: 'API publique sur 2M+ associations françaises actives (RNA, Ministère de l''Intérieur). Optimisée agents IA. IMPORTANT : la couverture des champs de contact (site_web, email, telephone) est ~0% à l''échelle (moins de 1 000 fiches enrichies) — voir le bloc `_coverage` de /search et la dataset card /.well-known/dataset.json.'
contact:
name: IA-Asso.fr
url: https://ia-asso.fr
license:
name: Licence Ouverte / Etalab
url: https://www.etalab.gouv.fr/licence-ouverte-open-licence
servers:
- url: https://ia-asso.fr/api
tags:
- name: Search
paths:
/search:
get:
operationId: searchAssociations
summary: Rechercher des associations (full-text + filtres territoire/thème)
description: 'Recherche Meilisearch. Rate limit : 20 req/min/IP. Retourne le squelette RNA (nom, objet, adresse, commune) ~100% rempli ; les champs de contact sont quasi vides hors sous-ensemble enrichi (voir `_coverage`).'
parameters:
- name: q
in: query
schema:
type: string
maxLength: 500
description: Mots-clés
- name: departement
in: query
schema:
type: string
maxLength: 3
description: Code INSEE département (ex "13", "75")
- name: region
in: query
schema:
type: string
maxLength: 100
description: Nom de région
- name: commune
in: query
schema:
type: string
description: Slug de commune (PLM inclus)
- name: epci
in: query
schema:
type: string
description: Slug d'EPCI
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 10000
default: 0
- name: lat
in: query
schema:
type: number
description: Latitude (recherche géo, avec lon)
- name: lon
in: query
schema:
type: number
description: Longitude
- name: radius
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
description: Rayon km
- name: scope
in: query
schema:
type: string
enum:
- national
- local
- name: premium
in: query
schema:
type: boolean
description: Restreindre au sous-ensemble enrichi/RUP
- name: rup
in: query
schema:
type: boolean
description: Restreindre aux reconnues d'utilité publique
- name: subventionnees
in: query
schema:
type: boolean
description: Restreindre aux assos avec financements publics connus
- name: hideInactive
in: query
schema:
type: boolean
description: Masquer les fiches potentiellement inactives (zombies)
responses:
'200':
description: Résultats
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: Paramètres invalides
'429':
description: Rate limit dépassé
tags:
- Search
/search/near-me:
get:
operationId: searchNearMe
summary: Associations autour d'un point (latitude, longitude)
parameters:
- name: latitude
in: query
required: true
schema:
type: number
- name: longitude
in: query
required: true
schema:
type: number
- name: q
in: query
schema:
type: string
description: Mots-clés (optionnel)
- name: radiusKm
in: query
schema:
type: integer
default: 50
description: Rayon en km
- name: limit
in: query
schema:
type: integer
default: 20
responses:
'200':
description: Résultats
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'400':
description: latitude et longitude requis
tags:
- Search
components:
schemas:
SearchResponse:
type: object
properties:
hits:
type: array
items:
$ref: '#/components/schemas/Association'
total:
type: integer
estimatedTotalHits:
type: integer
limit:
type: integer
offset:
type: integer
source:
type: string
example: RNA - Ministère de l'Intérieur
freshness:
type: string
example: '2026-10-01'
citation:
type: string
scope:
type: string
_coverage:
$ref: '#/components/schemas/Coverage'
Association:
type: object
properties:
id:
type: string
description: RNA id
nom:
type: string
objet:
type: string
description: Mission (texte RNA) — ~100% rempli
adresse:
type: string
code_postal:
type: string
commune:
type: string
departement:
type: string
region:
type: string
date_creation:
type: string
pathologie:
type:
- string
- 'null'
description: Classification santé — sous-ensemble
type_action:
type:
- string
- 'null'
tags_raw:
type:
- string
- 'null'
site_web:
type:
- string
- 'null'
description: ⚠️ ~0% rempli hors sous-ensemble enrichi
email:
type:
- string
- 'null'
description: ⚠️ ~0% rempli hors sous-ensemble enrichi
telephone:
type:
- string
- 'null'
description: ⚠️ ~0% rempli hors sous-ensemble enrichi
is_zombie:
type: boolean
Coverage:
type: object
description: Taux de remplissage réel des champs sur CE jeu de résultats — pour grounder sans échantillonner.
properties:
sample_size:
type: integer
filled_fraction:
type: object
additionalProperties:
type: number
description: fraction 0..1 par champ
note:
type: string
externalDocs:
description: Dataset card (couverture par champ)
url: https://ia-asso.fr/.well-known/dataset.json