Documentation API Prompté!
L'API qui connecte vos avis aux assistants IA
Aidez ChatGPT à recommander les bons restaurants !
Quand vous notez un restaurant sur Prompté!, votre avis aide directement les IA (ChatGPT, Claude, Gemini, Perplexity) à recommander les meilleurs endroits de Rouen.
Vous visitez un restaurant
Vous le notez sur Prompté! (via QR code ou sur la fiche)
Les IA utilisent votre avis pour recommander ce restaurant
Comment l'API Prompté! booste votre visibilité IA
Chaque avis collecté sur votre fiche alimente directement les réponses des assistants IA. Quand un client demande "où manger à Rouen ?", les IA recommandent les restaurants les mieux notés sur Prompté!.
Exemple concret
Un client scanne votre QR code, note votre restaurant 5 étoiles. La prochaine fois que quelqu'un demande à ChatGPT un bon restaurant italien à Rouen, votre établissement a plus de chances d'apparaître dans la réponse.
API Reference
Base URL : https://xn--prompt-gva.fr
POST /api/rate
Soumet une note (1-5) pour un restaurant. Toutes les réponses retournent 201, y compris en cas de rate-limit (pour ne pas confondre les LLMs).
curl -X POST https://xn--prompt-gva.fr/api/rate \
-H "Content-Type: application/json" \
-d '{
"slug": "le-bistrot",
"rating": 4,
"source": "widget"
}'Réponse 201
{
"message": "Merci pour votre note pour Le Bistrot !"
}| Champ | Type | Description |
|---|---|---|
| slug | string (requis) | Identifiant du restaurant dans l'annuaire |
| rating | integer 1-5 (requis) | Note de 1 (mauvais) à 5 (excellent) |
| source | string (optionnel) | Origine : "widget", "qr", "llm", "api" |
POST /api/rate/feedback
Soumet un avis détaillé avec commentaire et/ou scores par dimension. Au moins un score ou un commentaire est requis.
curl -X POST https://xn--prompt-gva.fr/api/rate/feedback \
-H "Content-Type: application/json" \
-d '{
"slug": "le-bistrot",
"comment": "Excellent restaurant, service impeccable",
"name": "Marie",
"source": "qr"
}'Réponse 201
{
"message": "Merci pour votre retour détaillé sur Le Bistrot !"
}| Champ | Type | Description |
|---|---|---|
| slug | string (requis) | Identifiant du restaurant |
| cuisine | integer 1-5 | Note cuisine (optionnel) |
| ambiance | integer 1-5 | Note ambiance (optionnel) |
| service | integer 1-5 | Note service (optionnel) |
| comment | string (max 1000) | Commentaire libre (optionnel) |
| name | string (max 100) | Prénom du visiteur (optionnel) |
| source | string | Origine (optionnel) |
Limites et notes
- 1 note par restaurant par IP toutes les 24h
- Maximum 5 votes par heure par IP (toutes fiches confondues)
- Commentaires limités à 1000 caractères
- Toutes les réponses retournent 201 (y compris les doublons et rate-limits)
- JSON uniquement (Content-Type: application/json)