API communiqués de presse et annonces d'entreprises

API REST pour lire le fil public et déposer un communiqué depuis vos outils. Chaque annonce porte son émetteur, son SIREN quand il est connu, et passe par la revue Clarsource avant publication.

Lire la documentationObtenir une clé

Pourquoi brancher Clarsource

Plutôt que de scraper des pages HTML, vous récupérez des annonces déjà structurées et rattachées à un émetteur identifié.

Émetteur et SIREN

Organisation nommée, avec SIREN quand il est connu, et statut de vérification.

Texte prêt à reprendre

Titre, chapô et corps validés, plus les liens fournis par l'émetteur.

PDF officiel

Quand l'émetteur a joint un fichier, l'API le sert aussi.

Ce que l'API fait aujourd'hui

Lecture du fil publié, dépôt en revue, export CSV.

Liste et détail

GET /api/v1/contents et GET /api/v1/contents/:id.

Dépôt automatisé

POST /api/v1/contents — toujours en revue éditoriale, jamais publié sans validation.

PDF

GET /api/v1/contents/:id/pdf quand un fichier est joint.

Export CSV

Même endpoint en ?format=csv, pour Excel ou Sheets.

Filtres utiles

Pour cibler ce que vous ingérez.

Organisation

Par slug d'émetteur (organization=).

Secteur

Par étiquette Clardot (sector=).

Pagination

limit et curseur pour les pages suivantes.

Documentation rapide

Authentification Bearer ou X-Api-Key. Créez votre clé dans l'espace.

Lire le fil

curl -H "Authorization: Bearer cw_…" \
  "https://clarsource.com/api/v1/contents?limit=10"

Déposer un communiqué

curl -X POST https://clarsource.com/api/v1/contents \
  -H "Authorization: Bearer cw_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Investissement de 18 M€…",
    "body": "Le communiqué complet…",
    "organization": {
      "name": "Forges de Vendée SAS",
      "siren": "412873590"
    }
  }'

Champs POST

Requis : title, body, organization (id ou name + siren). Optionnels : summary, language, distribution, embargo_until, links, press_contact.

Questions fréquentes

Faut-il une clé pour lire le fil ?

Oui. Activez une clé depuis votre espace Clarsource, puis passez-la en Authorization: Bearer … ou X-Api-Key.

Un dépôt via l'API est-il publié immédiatement ?

Non. Le communiqué est créé en PENDING_REVIEW. Rien n'apparaît sur le fil sans validation de la rédaction.

Quel format renvoie l'API ?

Du JSON. Un export CSV est aussi disponible via ?format=csv.

Y a-t-il des webhooks ou un flux RSS ?

Pas pour le moment. Vous pouvez interroger périodiquement GET /api/v1/contents avec un curseur.

Comment sont gérés les retraits ?

Une annonce retirée du fil public n'apparaît plus dans la liste. Les pages publiques indiquent le statut de retrait.

Quel est le tarif de l'API ?

La clé est disponible avec un compte. Les volumes importants peuvent être discutés avec l'équipe — hello@clarsource.com.

Clarsource pour d'autres métiers

Analystes et investisseursLevées, M&A, résultats : des données structurées pour la veille.JournalistesUn fil d'annonces sourcées, filtrable par secteur et région.EntreprisesCommuniqués de presse vérifiés et page organisation.

Des données d'entreprise que vos systèmes peuvent croire.

Créez une clé et commencez par un GET.

Obtenir une cléDocumentation