# Photo to Listing API

> Upload product photos, get optimized marketplace listings instantly via AI.

Photo to Listing is an AI-powered service that analyzes product photos and generates ready-to-publish listings for 12+ marketplaces (Leboncoin, Vinted, eBay, Etsy, etc.). The REST API lets AI agents and LLMs programmatically create listings.

## API Documentation

- [Full API Documentation](https://phototolisting.com/llms-full.txt): Complete endpoint specs, examples, and error codes
- [OpenAPI Specification](https://phototolisting.com/.well-known/openapi.json): Machine-readable API schema (OpenAPI 3.1.0)
- [Developer Page](https://phototolisting.com/developers): Getting started guide with examples

## Endpoints

- `POST /api/v1/listings` — Upload photos (base64), get marketplace listings back
- `GET /api/v1/usage` — Check remaining quota and plan info

## Authentication

API key via `X-API-Key` header. Keys use `ptl_` prefix.
Create keys at: https://phototolisting.com/account/api-keys

## Supported Platforms

leboncoin, vinted, marketplace, ebay, etsy, vestiaire, selency, poshmark, mercari, depop, craigslist, offerup

## Pricing

- Free: 3 generations/month
- Pro: Unlimited (monthly or annual subscription)
- Credit packs: 20 generations one-time purchase
- Details: https://phototolisting.com/pricing