REST API v1

API pour Agents IA

Envoyez des photos de produits, recevez des annonces marketplace pretes a publier. API REST avec authentification par cle API, quota et rate limiting.

Commencer OpenAPI Spec

Demarrage rapide

Obtenez une cle API

Creez un compte et generez une cle API depuis votre espace.

Gerer mes cles API

Verifiez votre quota

curl https://phototolisting.com/api/v1/usage \
  -H "X-API-Key: ptl_your_key_here"

Generez des annonces

curl -X POST https://phototolisting.com/api/v1/listings \
  -H "X-API-Key: ptl_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "photos": ["data:image/jpeg;base64,..."],
    "platforms": ["leboncoin", "vinted"],
    "language": "fr",
    "tone": "friendly"
  }'

Endpoints

Methode	Chemin	Description
POST	/api/v1/listings	Generer des annonces a partir de photos
GET	/api/v1/usage	Verifier le quota restant

Authentification

Toutes les requetes API necessitent une cle API transmise via le header X-API-Key.

X-API-Key: ptl_your_key_here

Les cles utilisent le prefixe ptl_ suivi de 64 caracteres hexadecimaux
Maximum 10 cles actives par compte
La cle est affichee une seule fois a la creation — sauvegardez-la

Limites et quota

Rate limiting

Free10 req/min

Pro60 req/min

Les headers X-RateLimit-Limit et X-RateLimit-Remaining sont inclus dans chaque reponse.

Quota de generations

Free3 / mois

ProIllimite

Pack credits20 generations

Exemple de reponse

{
  "success": true,
  "data": {
    "listings": [
      {
        "platform": "leboncoin",
        "title": "Veste en cuir noir - Taille M",
        "description": "Superbe veste en cuir véritable...",
        "price": 45,
        "category": "Vêtements",
        "condition": "Bon état"
      }
    ],
    "attributes": {
      "name": "Veste en cuir noir",
      "brand": "Unknown",
      "size": "M",
      "condition": "good",
      "color": "Noir",
      "material": "Cuir"
    },
    "suggestedPrice": 45
  },
  "usage": {
    "freeUsed": 1,
    "freeLimit": 3,
    "creditsRemaining": 0,
    "isSubscribed": false,
    "canGenerate": true
  }
}

Plateformes supportees

leboncoin

Leboncoin

France

vinted

Vinted

Europe

marketplace

Facebook Marketplace

Global

ebay

eBay

Global

etsy

Etsy

Global

vestiaire

Vestiaire Collective

Europe

selency

Selency

France

poshmark

Poshmark

mercari

Mercari

US/Japan

depop

Depop

UK/US

craigslist

Craigslist

offerup

OfferUp

Codes d'erreur

Code	Signification	Quand
400	Bad Request	Photos manquantes, plateforme invalide, trop de photos (max 4)
401	Unauthorized	Cle API manquante, invalide ou revoquee
402	Payment Required	Quota epuise — upgrade ou achat de credits
429	Too Many Requests	Rate limit depasse — voir header Retry-After
500	Server Error	Erreur de generation IA — reessayez

Ressources

OpenAPI Spec

Schema machine-readable

llms-full.txt

Documentation complete pour IA

Tarifs

Plans et credits

Pret a integrer ?

Commencez gratuitement avec 3 generations par mois. Passez a Pro pour un acces illimite.

Voir les tarifs