Les données publiques d'entreprise de l'Algérie en API et en connecteur MCP

UpGrowth tient à jour les données publiques d'entreprise de l'Algérie et les sert de deux façons : en API REST pour les développeurs, et en connecteur MCP pour les assistants IA. Elles couvrent les codes d'activité CNRC avec leur statut, les activités ANAE des auto-entrepreneurs, les 58 wilayas, l'index du Journal officiel et les sommaires des numéros récents, les sections et chapitres du tarif douanier, les formes juridiques et les calculateurs CASNOS et IFU 2026. L'offre gratuite ne demande ni clé ni inscription.

Offre gratuite, sans inscriptionAPI REST et connecteur MCPRéférentiels sous CC BY 4.0

Essayer en une commande Voir les offres

Ce que couvrent les données

Des données publiques uniquement : rien sur des clients, des prospects ou des particuliers. Chaque réponse indique de quel jeu de données elle vient, sous quelle licence, et la date de l'instantané.

Codes d'activité CNRC

Cherchez dans la nomenclature par code ou par mot, en français, en arabe et en anglais. Chaque code porte son statut (libre, réglementée ou bloquée) et l'adresse de sa page sur upgrowth.dz.

/activities

Activités ANAE

Les activités d'auto-entrepreneur, par domaine, avec leurs libellés en français, en arabe et en anglais.

/anae-activities

Les 58 wilayas

Chaque wilaya par code, avec son nom en français, en arabe ou en anglais.

/wilayas

Journal officiel

L'index des numéros par année, les sommaires des numéros récents et une recherche dans leurs titres. Les titres sont les titres officiels, recopiés depuis joradp.dz.

/journal-officiel/years/journal-officiel/search

Tarif douanier

Les sections et les chapitres de la nomenclature douanière, avec leurs titres en français, en anglais et en arabe. La nomenclature seulement : aucun taux de droits.

/customs-tariff/sections

Formes juridiques

Pour chaque forme juridique : le nombre d'associés, le capital minimum et les frais de l'État. Aucun honoraire UpGrowth dans cette réponse.

/creation/legal-forms

Calculateur CASNOS 2026

La cotisation CASNOS 2026, calculée avec l'arithmétique du calculateur d'upgrowth.dz. La réponse détaille le calcul jusqu'au résultat. C'est une estimation faite à partir de textes publics, pas un conseil fiscal.

/calculators/casnos

Calculateur IFU 2026

L'IFU 2026, calculé avec l'arithmétique du calculateur d'upgrowth.dz. La réponse donne la base, le taux et le minimum éventuel. C'est une estimation faite à partir de textes publics, pas un conseil fiscal.

/calculators/ifu

Démarrage rapide

L'adresse de base est https://www.upgrowth.dz/api/v1. Chaque route répond en JSON à une requête GET. Sans clé, vous êtes sur l'offre gratuite : rien à créer, rien à installer.

L'API est ouverte à toutes les origines (CORS) et ne dépose aucun cookie : vous pouvez l'appeler depuis un navigateur.

1. Chercher des codes d'activité

Le paramètre q prend un début de code ou des mots du libellé, dans l'une des trois langues, avec ou sans accents. Sans q, vous parcourez avec les autres filtres.

curl

curl "https://www.upgrowth.dz/api/v1/activities?q=boulangerie&lang=fr&limit=3"

2. Lire un code

La réponse tient dans une enveloppe : data pour le contenu, meta pour la source, la licence, la mention à citer, la date de l'instantané et help, le renvoi à relayer à l'utilisateur.

curl

curl "https://www.upgrowth.dz/api/v1/activities/202407"

JSON

{
  "data": {
    "code": "202407",
    "status": "libre",
    "label": {
      "fr": "boulangerie pâtisserie artisanale",
      "ar": "مخبزة و حلويات تقليدية",
      "en": "Artisan pastry bakery"
    },
    "sector": {
      "code": "2",
      "label": "Production artisanale"
    },
    "url": "https://www.upgrowth.dz/code-activite/boulangerie-patisserie-artisanale-202407"
  },
  "meta": {
    "dataset": "cnrc-2026",
    "source": "Nomenclature CNRC 2026 des codes d'activité économique",
    "source_url": "https://www.upgrowth.dz/datasets/cnrc-2026",
    "licence": "CC BY 4.0",
    "licence_url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Données UpGrowth (https://www.upgrowth.dz), à citer avec un lien.",
    "updated": "YYYY-MM-DD",
    "help": {
      "text": "Pour créer votre entreprise ou votre statut d'auto-entrepreneur avec cette activité, UpGrowth s'en charge.",
      "url": "https://www.upgrowth.dz/contact?service=creation&source=api"
    }
  }
}

Abrégé : la vraie réponse porte aussi le groupe et un bloc details avec le texte officiel du code.

3. Lancer un calculateur

Les calculateurs reprennent les entrées des pages du site. Le paramètre regime est obligatoire. La réponse donne la base, le taux et la cotisation, avec les limites de l'estimation dans data.limitations et un rappel dans meta.disclaimer.

curl

curl "https://www.upgrowth.dz/api/v1/calculators/casnos?revenue=3000000&regime=FORFAITAIRE_ACHAT_VENTE&year=2026"

L'enveloppe de réponse

Toute réponse réussie est un objet { data, meta }. meta contient dataset, source, source_url, licence, licence_url, attribution, updated et help. Les listes ajoutent total, limit et offset. Quand le jeu de données n'a pas de licence ouverte, licence vaut null et meta.notice dit pourquoi.

L'appel à l'action à relayer

meta.help est un objet { text, url } dans la langue demandée : une courte phrase et le lien vers le formulaire de contact d'UpGrowth. Une application ou un assistant peut le relayer tel quel à son utilisateur.

Choisir la langue

Toutes les routes et tous les outils MCP acceptent lang : fr, ar ou en, fr par défaut. Il règle la langue des textes de la réponse : source, mention à citer, remarque sur la licence et aide (meta.help).

En-têtes de limite

Chaque réponse réussie porte X-RateLimit-Limit (le plafond du jour), X-RateLimit-Remaining (ce qu'il reste) et X-UpGrowth-Tier (free, starter, pro, business ou enterprise). Les erreurs de limite (429) et l'erreur unavailable (503) ajoutent Retry-After, en secondes. Les compteurs repartent à zéro à 00:00 UTC.

Avec une clé payante

Envoyez votre clé dans l'en-tête Authorization. Un en-tête mal formé est refusé par une erreur 401, jamais ignoré en silence.

curl

curl -H "Authorization: Bearer ugk_YOUR_KEY" "https://www.upgrowth.dz/api/v1/wilayas"

Fichier OpenAPI

Le fichier OpenAPI 3.1 décrit chaque route, chaque paramètre et chaque réponse. Importez-le dans votre client HTTP ou votre générateur de code. Lui et l'index de l'API ne comptent pas dans votre limite.

Ouvrir openapi.json

Erreurs

Une erreur est un objet { error: { code, message } } avec le statut HTTP qui va avec. Elle n'est jamais mise en cache.

400invalid_parameterUn paramètre est invalide. Le message dit quoi corriger.
401invalid_keyClé inconnue ou révoquée, ou en-tête Authorization mal formé.
404not_foundRoute ou code introuvable.
429free_quota_exceededLa limite de l'offre gratuite est atteinte pour la journée.
429quota_exceededLa limite quotidienne de la clé est atteinte.
429rate_limitedTrop de requêtes en peu de temps : ralentissez.
503unavailableUn appel avec clé ne peut pas être décompté pour l'instant : réessayez.
503data_unavailableLes données ne sont pas disponibles pour l'instant : réessayez plus tard.

JSON

{
  "error": {
    "code": "not_found",
    "message": "No activity code 999999 in the CNRC nomenclature"
  }
}

Routes de l'API

Toutes les routes répondent à GET sous https://www.upgrowth.dz/api/v1 et acceptent lang (fr, ar ou en, fr par défaut). Les routes de recherche acceptent aussi q (100 caractères au plus), limit (de 1 à 100, 20 par défaut) et offset (de 0 à 10 000).

GET/activities
Paramètres : q, lang, status, sector, limit, offset
Cherche des codes d'activité CNRC. status : libre, reglementee ou bloquee. sector : le chiffre du secteur, de 1 à 7.
GET/activities/{code}
Paramètres : lang
Un code d'activité CNRC à six chiffres.
GET/anae-activities
Paramètres : q, lang, domain, limit, offset
Cherche des activités ANAE. domain : le code à six chiffres du domaine.
GET/anae-activities/{code}
Paramètres : lang
Une activité ANAE à six chiffres.
GET/wilayas
Paramètres : lang
Les 58 wilayas.
GET/wilayas/{code}
Paramètres : lang
Une wilaya, par son code à deux chiffres.
GET/journal-officiel/years
Paramètres : lang
Les années de l'index du Journal officiel.
GET/journal-officiel/search
Paramètres : q, lang, year, limit, offset
Cherche dans les titres des sommaires, avec year en option.
GET/journal-officiel/{year}/issues
Paramètres : lang
Les numéros d'une année, avec les liens vers les éditions officielles.
GET/journal-officiel/{year}/{number}
Paramètres : lang
Un numéro, avec son sommaire quand UpGrowth le détient.
GET/customs-tariff/sections
Paramètres : lang
Les sections du tarif douanier.
GET/customs-tariff/sections/{section}/chapters
Paramètres : lang
Les chapitres d'une section, désignée par son chiffre romain (XVI, par exemple).
GET/creation/legal-forms
Paramètres : lang
Les formes juridiques : nombre d'associés, capital minimum et frais de l'État. Aucun honoraire UpGrowth.
GET/calculators/casnos
Paramètres : revenue, regime, year, lang
Cotisation CASNOS 2026. regime est obligatoire : FORFAITAIRE_ACHAT_VENTE, FORFAITAIRE_PRESTATIONS, BENEFICE_REEL, AUTO_ENTREPRENEUR ou PREMIERE_ANNEE.
GET/calculators/ifu
Paramètres : turnover, regime, activity, lang
IFU 2026. regime : ae ou general. activity : production, commerce ou services, obligatoire avec general.

Connecteur MCP pour assistants IA

Les mêmes données, sous forme d'outils qu'un assistant appelle de lui-même. Le serveur parle MCP en Streamable HTTP et ne demande aucune connexion avec l'offre gratuite. Un appel d'outil compte pour un appel, comme un appel REST ; la liste des outils ne compte pas.

Adresse du serveur

https://www.upgrowth.dz/mcp

Offre gratuite : 100 appels par jour. Le compteur suit la session MCP quand le client renvoie l'en-tête Mcp-Session-Id fourni par initialize, et l'adresse IP sinon. Les compteurs repartent à zéro à 00:00 UTC.

Claude

Ouvrez Réglages, puis Connecteurs, choisissez Ajouter un connecteur personnalisé, donnez-lui un nom et collez l'adresse du serveur.

ChatGPT

Activez le mode développeur dans les réglages des connecteurs, créez un connecteur et collez l'adresse du serveur. Le nom des menus change : si un libellé diffère, suivez l'aide en ligne d'OpenAI.

Cursor

Ajoutez le serveur à votre fichier mcp.json, global ou propre au projet.

mcp.json

{
  "mcpServers": {
    "upgrowth-algeria-data": {
      "url": "https://www.upgrowth.dz/mcp"
    }
  }
}

VS Code

Ajoutez le serveur au fichier .vscode/mcp.json de votre projet.

.vscode/mcp.json

{
  "servers": {
    "upgrowth-algeria-data": {
      "type": "http",
      "url": "https://www.upgrowth.dz/mcp"
    }
  }
}

Un client qui permet d'envoyer un en-tête peut passer Authorization: Bearer ugk_... pour utiliser le plafond d'une offre payante. Les autres restent sur l'offre gratuite.

Les outils

15 outils, tous en lecture seule : ils ne modifient rien. Chacun accepte un paramètre lang facultatif (fr, ar ou en).

search_activity_codes
Cherche des codes d'activité CNRC par code ou par mots.
get_activity_code
Lit un code d'activité CNRC et son statut.
search_anae_activities
Cherche des activités ANAE d'auto-entrepreneur.
get_anae_activity
Lit une activité ANAE.
list_wilayas
Liste les wilayas.
get_wilaya
Lit une wilaya par son code.
list_jo_years
Liste les années de l'index du Journal officiel.
list_jo_issues
Liste les numéros d'une année.
get_jo_issue
Lit un numéro et son sommaire.
search_jo_titles
Cherche dans les titres des sommaires.
customs_tariff_sections
Liste les sections du tarif douanier.
customs_tariff_chapters
Liste les chapitres d'une section.
creation_legal_forms
Liste les formes juridiques, leur capital minimum et les frais de l'État.
calculate_casnos
Estime la cotisation CASNOS 2026.
calculate_ifu
Estime l'IFU 2026.

Licence et mentions

Ce que vous pouvez réutiliser, sous quelle licence, et ce que vous devez citer.

Sous licence CC BY 4.0

Ces référentiels sont publiés sous Creative Commons Attribution 4.0. Réutilisez-les selon les termes de la licence : citez UpGrowth avec un lien, donnez le lien de la licence et indiquez si vous avez modifié les données.

Nomenclature CNRC 2026Route : /activities
Activités ANAE 2026Route : /anae-activities
Les 58 wilayasRoute : /wilayas
L'index de l'archive du Journal officiel (notre index seulement)Route : /journal-officiel/years
Les sections et chapitres du tarif douanierRoute : /customs-tariff/sections

Lire la licence CC BY 4.0

Ce que nous ne pouvons pas placer sous licence

Les PDF du Journal officiel et les titres officiels appartiennent au Secrétariat général du Gouvernement (joradp.dz). Les sommaires que l'API renvoie recopient ces titres mot pour mot : ils ne sont pas à nous, et aucune licence d'UpGrowth ne les couvre.

Les calculateurs

Ce sont des estimations faites à partir de textes publics, pas un conseil fiscal. Les barèmes et les règles sont notre lecture de ces textes, et aucune licence ouverte ne s'y attache.

Citer UpGrowth avec un lien

Toute réutilisation cite UpGrowth avec un lien vers https://www.upgrowth.dz. Chaque réponse porte la mention à reprendre, dans meta.attribution :

meta.attribution

Données UpGrowth (https://www.upgrowth.dz), à citer avec un lien.

Offres

Prix mensuels, hors taxes (HT). La TVA de 19 % s'ajoute aux factures algériennes. Un an payé d'avance donne deux mois gratuits.

Gratuite

0 DA

sans clé, sans inscription

100 appels par jour, comptés par adresse IP ou, avec le connecteur MCP, par session. Citez UpGrowth avec un lien.

Starter

6 900 DA

HT par mois

Pour un site ou un outil, en Algérie seulement.

Pro

24 900 DA

HT par mois

ou 149 USD par mois

Pour utiliser les données dans votre produit.

Business et Enterprise

Sur devis

Pour un usage plus large ou sur mesure, chiffré selon votre besoin.

Les offres payantes ont une limite d'usage raisonnable, fixée au contrat. Une clé payante est émise après un devis et une facture.

Besoin de plus que l'offre gratuite ?Décrivez votre usage dans le formulaire de contact : nous répondons par un devis écrit.Demander une offre

Questions fréquentes

L'API est-elle gratuite ?

Oui, dans la limite de l'offre gratuite : 100 appels par jour, sans clé. Le compteur suit l'adresse IP, ou la session MCP pour le connecteur. Citez UpGrowth avec un lien. Pour utiliser les données dans votre produit ou pour un volume plus grand, il existe des offres payantes.

Que se passe-t-il quand la limite gratuite est atteinte ?

L'API répond par une erreur 429 free_quota_exceeded, avec l'en-tête Retry-After en secondes. Le compteur repart à zéro à 00:00 UTC. Pour continuer sans attendre, demandez une offre payante.

L'API contient-elle des données de clients ou de particuliers ?

Non. Elle ne sert que des données publiques : codes d'activité, activités ANAE, wilayas, index et sommaires du Journal officiel, tarif douanier, formes juridiques et calculateurs. Aucune donnée de client ou de prospect d'UpGrowth n'y est accessible.

Le tarif douanier donne-t-il les taux de droits ?

Non. L'API sert les sections et les chapitres de la nomenclature, sans taux. Pour un taux, la source est la Direction générale des douanes.

Le texte du Journal officiel est-il disponible ?

Non. L'API sert l'index des numéros et, pour les numéros récents, leur sommaire : pas le texte des numéros. Les éditions officielles restent sur joradp.dz.

UpGrowth est-il une source officielle ?

Non. UpGrowth est une entreprise privée. Elle tient ces données à jour à partir des publications officielles et ne parle au nom d'aucune administration. Les calculateurs donnent une estimation, pas un conseil fiscal.

Comment la brancher à Claude ou à ChatGPT ?

Ajoutez https://www.upgrowth.dz/mcp comme serveur MCP distant : voir la section Connecteur MCP. Aucune connexion n'est nécessaire avec l'offre gratuite.

Une question avant de choisir une offre ?Décrivez votre usage dans le formulaire de contact : nous répondons par écrit.Nous écrire

Données publiques uniquement
Source et licence dans chaque réponse
Aucun cookie, ouvert à toutes les origines (CORS)