Listing Generation API

Quickstart

Get started in 30 seconds. 10 free listings/month, no credit card required.

1. Get your API key

Sign up at fliplistai.com, then generate an API key from your dashboard.

2. Generate a listing

curl -X POST https://fliplist-api.sundeen10.workers.dev/api/v1/generate \
  -H "X-API-Key: fl_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "images": ["BASE64_IMAGE_DATA"],
    "platform": "ebay",
    "description": "Nike Air Max 90, size 10, barely worn",
    "condition": "Like New"
  }'

Generate for all 5 platforms at once

curl -X POST https://fliplist-api.sundeen10.workers.dev/api/v1/generate \
  -H "X-API-Key: fl_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "images": ["BASE64_IMAGE_DATA"],
    "platform": "all"
  }'

JavaScript Example

// Convert image to base64
var reader = new FileReader();
reader.onload = async function(e) {
  var base64 = e.target.result.split(",")[1];

  var res = await fetch("https://fliplist-api.sundeen10.workers.dev/api/v1/generate", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "fl_your_api_key_here"
    },
    body: JSON.stringify({
      images: [base64],
      platform: "all",              // or "ebay", "poshmark", etc.
      description: "Optional notes", // brand, flaws, etc.
      condition: "Like New"          // optional
    })
  });

  var data = await res.json();
  console.log(data.listing);
  // data.listing.title, data.listing.description,
  // data.listing.priceLow/Mid/High, data.listing.tags, etc.
};
reader.readAsDataURL(imageFile);

Python Example

import requests, base64

with open("product.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

resp = requests.post(
    "https://fliplist-api.sundeen10.workers.dev/api/v1/generate",
    headers={"X-API-Key": "fl_your_api_key_here"},
    json={
        "images": [image_b64],
        "platform": "ebay",
        "description": "Nike Air Max 90, worn twice",
        "condition": "Like New"
    }
)
listing = resp.json()["listing"]
print(listing["title"])
print(listing["description"])
print(f"Price: ${listing['priceMid']}")

API Reference

Generate an optimized listing from product photos and/or description.

Headers

Request Body

* At least one of images or description is required.

{
  "listing": {
    "item": { "brand": "Nike", "type": "Sneakers", "condition": "Like New", ... },
    "title": "Nike Air Max 90 Men's Size 10 Like New White ...",
    "description": "Up for sale is a pristine pair of Nike Air Max 90...",
    "category": "Clothing, Shoes & Accessories > Men > Athletic Shoes",
    "priceLow": 65,
    "priceMid": 85,
    "priceHigh": 110,
    "tags": ["Nike", "Air Max 90", "Sneakers", ...],
    "hashtags": ["#Nike", "#AirMax", "#Sneakers", ...],
    "isRare": false,
    "rareReason": null,
    "qualityScore": 82,
    "improvements": ["Add close-up of sole wear", "Mention original box"]
  },
  "platform": "ebay",
  "usage": { "used": 3, "limit": 10, "remaining": 7 }
}

Check your current usage and remaining quota.

{
  "tier": "free",
  "tier_name": "Free",
  "monthly_limit": 10,
  "monthly_used": 3,
  "monthly_remaining": 7,
  "period": "2026-03"
}

API Pricing

Start free. Each listing includes AI photo analysis, optimized copy, pricing, tags, and quality score.

Use Cases

Embed Widget

Add FlipList's listing generator to your website:

<iframe
  src="https://fliplistai.com?embed=true&key=fl_your_api_key"
  width="100%" height="700"
  style="border:none;border-radius:12px"
></iframe>

Support

Questions? Email [email protected] or open an issue on GitHub.