First REST request

From zero to your first API response in under 2 minutes.

Just want to use Normi in Claude or ChatGPT?

No key needed: add a connector with the URL https://mcp.normi.fr/mcp, sign in to Normi and approve. Install guide. This page covers the REST API, which works with an API key.

Get an API key

Create an account (Google OAuth, free), then go to Dashboard → Tokens → Create a token.

# Create an account and go to Dashboard → Tokens → Create a token
# Copy your token (shown only once)
# Example token: normi_abc123...

500 free credits a month

Every new account gets 500 free credits. That's enough for ~100 basic requests. Credits are topped up to 500 on the 1st of each month.

Make your first request

Replace normi_your_token with your token and run:

curl "https://mcp.normi.fr/v1/stats/market?code_postal=75001" \
  -H "X-API-Key: normi_your_token"

Query parameters and response fields use French names (code_postal, date_debut…), matching the DVF source data.

Read the response

You should get something like:

{
  "count": 563,
  "price": {
    "median": 527600,
    "avg": 1836728,
    "min": 7950,
    "max": 122000000
  },
  "price_per_m2": {
    "median": 12301,
    "avg": 12835
  },
  "filters": { "code_postal": "75001" },
  "notice": "Applied date_debut=2023-03-11 automatically",
  "_credits": { "used": 5, "remaining": 95 },
  "query_time_ms": 1025
}

price.medianMedian price in euros for the area

price_per_m2.medianMedian price per m²

_credits.remainingCredits left after this request

noticeAppears when the request was auto-limited (date_debut added automatically)

Next steps

Search transactions →

Filter by type, price, surface, date (reference in French)

Find comparables →

Estimate a property's value (reference in French)

Price trends →

Monthly, quarterly, yearly evolution (reference in French)

Install the MCP server →

Connect Normi to Claude Desktop

If something goes wrong

401: missing or invalid API key. Check the X-API-Key header.
400: missing parameter. Every endpoint requires at least one location filter.
402: insufficient credits. Buy credits from the dashboard.

Connect LangChain

Authentication