Récupérer les données Braineet en JSON

Vous pouvez récupérer les données de votre plateforme Braineet Crowdsourcing via nos API d'export publiques. Ces endpoints permettent d'extraire les données au format JSON pour vos analyses, vos rapports ou l'intégration à d'autres outils.

Pour récupérer vos données, utilisez l'endpoint Data URL avec une authentification Basic.

URL de base

L'URL de base de l'API est :

https://<votre-sous-domaine>.<votre-domaine-racine>/api/exports/

Par exemple, si l'URL de votre plateforme est https://ideas.braineet.com , alors :

platform = ideas
platformDomain = braineet.com

Avec un domaine personnalisé comme ideas.votreentreprise.com :

platform = ideas
platformDomain = votreentreprise.com

Authentification

Tous les endpoints d'export sont protégés par authentification Basic. Il vous faut un identifiant et un mot de passe valides.

🔐 Obtenir vos identifiants — pour demander votre identifiant et mot de passe d'API :

E-mail : [email protected]
Ou contactez votre Customer Success Manager (CSM) Braineet.

Précisez l'URL de votre plateforme et l'objet de l'accès dans votre demande.

L'authentification Basic est intégrée au protocole HTTP : le client envoie une requête avec l'en-tête Authorization contenant le mot Basic , un espace, puis la chaîne identifiant:motdepasse encodée en base64. Par exemple, pour s'authentifier en tant que pierre.gourlaouen / APIKEYCODE123 :

Authorization: Basic cGllcnJlLmdvdXJsYW91ZW5AYnJhaW5lZXQuY29tOkFQSUtFWUNPREUxMjM=

Remarque : le base64 se décode facilement — l'authentification Basic ne doit être utilisée qu'avec HTTPS/SSL.

Paramètres de requête courants

Paramètre	Type	Requis	Description
`page`	Entier	Oui	Numéro de page (à partir de 1).
`limit`	Entier	Oui	Nombre de résultats par page (maximum : 200).
`platform`	Chaîne	Oui	Le sous-domaine de votre plateforme (ex. `ideas`).
`platformDomain`	Chaîne	Oui	Le domaine racine (ex. `braineet.com`).
`since`	DateTime	Optionnel	Ne renvoie que les résultats créés/mis à jour après cette date (ISO 8601).
`orderBy`	Chaîne	Optionnel	Tri `ASC` ou `DESC` (par défaut `DESC`).

Spécifications de l'API

Les données JSON sont structurées ainsi : un tableau d'objets. Chaque objet est une map[string]any où chaque clé est le nom d'un champ personnalisé, et la valeur dépend du type de champ (nombre, chaîne, ou tableau de chaînes pour les champs à valeurs multiples).

[
  { "project_name": "New Marketing Initiative", "start_date": "2025-02-01", "budget": 50000, "tags": ["marketing", "sales"] },
  { "project_name": "Website Redesign", "start_date": "2025-04-10", "budget": 75000, "tags": ["design", "web"] }
]

Endpoints disponibles

Ressource	Endpoint
Idées (publications)	`/contents`
Likes	`/likes`
Challenges	`/challenges`
Votes de challenge	`/challenge_votes`
Articles	`/articles`
Sondages	`/surveys`
Commentaires	`/comments`
Candidats	`/applicants`
Vues	`/views`
Vues quotidiennes	`/daily_views`
Membres	`/members`
Invitations	`/invitations`
Abonnés (followers)	`/followers`
Pièces jointes	`/content_attachments`

Uniquement les contenus nouveaux ou modifiés

Utilisez le paramètre since (format ISO 8601) pour ne récupérer que les contenus créés ou modifiés depuis une date : ?since=2025-03-08T00:00:00Z . Seuls les champs créés ou modifiés depuis cet horodatage sont renvoyés avec leur valeur actuelle ; un champ non modifié apparaît à null .

Exemples de requêtes

Récupérer les 200 premières idées :

GET https://team-preprod.braineet.com/api/exports/contents?page=1&limit=200&platform=ideas&platformDomain=braineet.com

Filtrer par date et trier en ordre croissant :

GET https://ideas.votreentreprise.com/api/exports/comments?page=1&limit=200&since=2025-01-01T00:00:00Z&orderBy=ASC&platform=ideas&platformDomain=votreentreprise.com

Notes

Les réponses sont au format JSON.
La pagination est obligatoire pour les gros volumes (utilisez page ).
Le paramètre since est idéal pour des exports incrémentaux.