Skip to main content
Spec-only preview. The API is not yet live. The commands below will not return real responses today; they describe the developer experience we are shipping. Talk to us about closed-beta access.
You need an API key from the team and a domain name agreed with us (dating, hiring, etc.). After that, three endpoints get you a working integration.

​
Authenticate

export JEAN_API_KEY=sk_live_...
Every request takes Authorization: Bearer $JEAN_API_KEY.

​
1. Add a user

Send raw text and let the platform extract structure, or send fields directly if you already have it. 
curl https://api.jeantechnologies.com/v1/users \
  -H "Authorization: Bearer $JEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "u_alice",
    "domain": "dating",
    "context": "32, NYC, looking for someone serious. Reads a lot, runs in the park, vegetarian."
  }'

​
2. Find matches

curl https://api.jeantechnologies.com/v1/match \
  -H "Authorization: Bearer $JEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "u_alice",
    "domain": "dating",
    "limit": 10
  }'
Add "filters": { "location_within_km": 50 } to apply hard constraints. Stages can be tuned via "stages": { "llm_judge": true } (off by default for latency).

​
3. Send feedback

curl https://api.jeantechnologies.com/v1/feedback \
  -H "Authorization: Bearer $JEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "dating",
    "items": [
      { "seeker_id": "u_alice", "candidate_id": "u_bob",  "outcome": "accepted" },
      { "seeker_id": "u_alice", "candidate_id": "u_carl", "outcome": "rejected" }
    ]
  }'
Outcomes accumulate. Past a per-domain threshold the ranker auto-fine-tunes; force it manually with POST /train.

​
Next

Concepts

Users, schemas, matches, feedback.

API Reference

Live playground.