Seller API

Authorization: Bearer fgk_live_…
Base address:  https://www.filagora.com/api/v1

curl https://www.filagora.com/api/v1/listings \
  -H "Authorization: Bearer $FILAGORA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "vase-001",
    "title": "Spiral Bud Vase, 15 cm",
    "description": "A twisted bud vase printed in matte PLA.\n\nWatertight with the glass insert.",
    "category": "vases-planters",
    "tags": ["vase", "spiral", "minimal"],
    "images": ["https://example.com/vase-front.jpg", "https://example.com/vase-side.jpg"],
    "physical": { "price": 24, "colors": ["White", "Sage"], "materials": ["PLA"], "leadDays": 3 },
    "designSource": "own",
    "madeBy": "shop",
    "standardsOk": true
  }'

{
  "slug": "spiral-bud-vase-15-cm",
  "status": "active",
  "created": true,
  "publishAt": null,
  "url": "https://www.filagora.com/product/spiral-bud-vase-15-cm"
}

{
  "externalId": "vase-001-file",
  "title": "Spiral Bud Vase — STL file",
  "description": "Print it yourself: 15 cm tall, no supports, about 3 hours.",
  "category": "vases-planters",
  "tags": ["vase", "stl", "vase mode"],
  "images": ["https://example.com/vase-front.jpg"],
  "digital": {
    "price": 4.5,
    "license": "personal",
    "files": [
      { "url": "https://example.com/files/spiral-vase.stl" },
      { "url": "https://example.com/files/print-guide.pdf" }
    ]
  },
  "designSource": "own",
  "madeBy": "shop",
  "standardsOk": true
}

{
  "slug": "spiral-bud-vase-stl-file",
  "status": "active",
  "created": true,
  "url": "https://www.filagora.com/product/spiral-bud-vase-stl-file",
  "files": [
    { "name": "spiral-vase-1a2b3c4d.stl", "format": "stl", "size": 1840584, "status": "new" },
    { "name": "print-guide-9f8e7d6c.pdf", "format": "pdf", "size": 210233, "status": "new" }
  ]
}

"digital": {
  "price": 2,
  "files": [
    { "name": "tetra.stl", "text": "solid tetra\n facet normal 0 0 1\n  outer loop\n   vertex 0 0 0\n   vertex 10 0 0\n   vertex 0 10 0\n  endloop\n endfacet\nendsolid tetra\n" },
    { "name": "print-settings.txt", "text": "0.2 mm layers, 15% infill, no supports." }
  ]
}

curl https://www.filagora.com/api/v1/listings \
  -H "Authorization: Bearer $FILAGORA_KEY" \
  -F 'listing={"externalId":"planter-01","title":"Hex Planter — 3MF and STL","description":"Two sizes in one project.","category":"vases-planters","digital":{"price":5},"designSource":"own","madeBy":"shop","standardsOk":true}' \
  -F "images=@planter.jpg" \
  -F "files=@planter.3mf" \
  -F "files=@planter.stl" \
  -F "files=@assembly.pdf"

curl https://www.filagora.com/api/v1/files \
  -H "Authorization: Bearer $FILAGORA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "dragon.stl", "size": 38200000 }'

{
  "upload": "dragon-1a2b3c4d.stl",
  "uploadUrl": "https://…",
  "method": "PUT",
  "headers": { "content-type": "application/octet-stream" },
  "maxBytes": 52428800,
  "expiresInSeconds": 7200
}

curl -X PUT "$UPLOAD_URL" -H "Content-Type: application/octet-stream" --data-binary @dragon.stl

"digital": { "price": 12, "files": [ { "upload": "dragon-1a2b3c4d.stl" } ] }

import { readFile } from "node:fs/promises";

const stl = await readFile("spiral-vase.stl");
const res = await fetch("https://www.filagora.com/api/v1/listings", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.FILAGORA_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    externalId: "vase-001-file",
    title: "Spiral Bud Vase — STL file",
    description: "Print it yourself: 15 cm tall, no supports.",
    category: "vases-planters",
    tags: ["vase", "stl"],
    images: ["https://example.com/vase-front.jpg"],
    digital: { price: 4.5, files: [{ name: "spiral-vase.stl", base64: stl.toString("base64") }] },
    designSource: "own", madeBy: "shop", standardsOk: true,
  }),
});
console.log(res.status, await res.json());

import json, os, requests

listing = {
    "externalId": "planter-01",
    "title": "Hex Planter",
    "description": "Printed in matte PLA, or print it yourself from the 3MF.",
    "category": "vases-planters",
    "tags": ["planter", "hexagon"],
    "physical": {"price": 22, "colors": ["Sage", "White"]},
    "digital": {"price": 5},
    "designSource": "own", "madeBy": "shop", "standardsOk": True,
}
with open("planter.jpg", "rb") as photo, open("planter.3mf", "rb") as model:
    r = requests.post(
        "https://www.filagora.com/api/v1/listings",
        headers={"Authorization": f"Bearer {os.environ['FILAGORA_KEY']}"},
        data={"listing": json.dumps(listing)},
        files=[("images", ("planter.jpg", photo)), ("files", ("planter.3mf", model))],
    )
print(r.status_code, r.json())

import os, requests

H = {"Authorization": f"Bearer {os.environ['FILAGORA_KEY']}"}
up = requests.post("https://www.filagora.com/api/v1/files", headers=H, json={"name": "dragon.stl"}).json()
with open("dragon.stl", "rb") as f:
    requests.put(up["uploadUrl"], data=f, headers=up["headers"]).raise_for_status()

r = requests.post("https://www.filagora.com/api/v1/listings", headers=H, json={
    "externalId": "dragon-01",
    "title": "Articulated Dragon — print-in-place STL",
    "description": "Prints in one piece, no supports.",
    "category": "toys-figurines",
    "images": ["https://example.com/dragon.jpg"],
    "digital": {"price": 6, "files": [{"upload": up["upload"]}]},
    "designSource": "own", "madeBy": "shop", "standardsOk": True,
})
print(r.status_code, r.json())