Use this when the user wants to offer a good or service for barter on TraydStar. Publishes a public listing on their account and returns its id. Photos can't be attached here; the user can add them on the website. Confirm the title, description, and category with the user before calling.
View input schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 100,
"description": "Short name of what is offered"
},
"description": {
"type": "string",
"minLength": 10,
"maxLength": 5000,
"description": "What is offered, in the user's words"
},
"type": {
"type": "string",
"enum": [
"GOOD",
"SERVICE",
"BOTH"
],
"description": "GOOD for a physical item, SERVICE for work, BOTH if it includes both"
},
"category": {
"type": "string",
"enum": [
"Cameras & Photo",
"Trading Cards",
"Sneakers",
"Electronics",
"Collectibles",
"Sports & Outdoors",
"Home & Garden",
"Clothing & Accessories",
"Books & Media",
"Vehicles & Parts",
"Art & Crafts",
"Other Goods",
"Design Services",
"Tech Services",
"Creative Services",
"Professional Services",
"Home Services",
"Other Services"
],
"description": "The category it belongs in"
},
"subcategory": {
"description": "A subcategory of that category, if one applies. Cameras & Photo: Camera Bodies, Lenses, Film Cameras, Lighting & Flash, Tripods & Support, Bags & Accessories, Video & Drones. Trading Cards: Pokémon, Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana, Other TCG, Baseball, Basketball, Football, Hockey, Soccer, Other Sports, Sealed Product. Sneakers: Jordan, Nike, Adidas, New Balance, Asics, Other Brands. Collectibles: Coins & Currency, Comics, Toys & Figures, LEGO, Vinyl, Sports Memorabilia, Other Collectibles.",
"type": "string",
"maxLength": 50
},
"condition": {
"description": "Condition, for physical goods",
"type": "string",
"enum": [
"NEW",
"LIKE_NEW",
"GOOD",
"FAIR",
"POOR"
]
},
"details": {
"type": "object",
"properties": {
"set": {
"description": "Trading Cards: set or series, e.g. Base Set, 2023 Topps Chrome",
"type": "string",
"maxLength": 80
},
"year": {
"description": "Trading Cards: year printed",
"type": "integer",
"minimum": 1860,
"maximum": 2100
},
"card_number": {
"description": "Trading Cards: number on the card, e.g. 4/102",
"type": "string",
"maxLength": 20
},
"subject": {
"description": "Trading Cards: player or character",
"type": "string",
"maxLength": 80
},
"variant": {
"description": "Trading Cards: holo, 1st edition, parallel, refractor and so on",
"type": "string",
"maxLength": 80
},
"graded": {
"description": "Trading Cards: true for a slabbed card (then give grader and grade), false or omitted for raw",
"type": "boolean"
},
"card_condition": {
"description": "Trading Cards: condition of a raw card",
"type": "string",
"enum": [
"Near Mint",
"Lightly Played",
"Moderately Played",
"Heavily Played",
"Damaged"
]
},
"grader": {
"description": "Trading Cards: grading company of a graded card",
"type": "string",
"enum": [
"PSA",
"BGS",
"CGC",
"SGC",
"Other"
]
},
"grade": {
"description": "Trading Cards: grade on the slab, e.g. 10 or 9.5",
"type": "string",
"maxLength": 12
},
"cert_number": {
"description": "Trading Cards: certification number on the slab label, so the other side can look it up",
"type": "string",
"maxLength": 24
},
"model": {
"description": "Sneakers: model, e.g. Air Jordan 1 High OG",
"type": "string",
"maxLength": 80
},
"colorway": {
"description": "Sneakers: colorway name",
"type": "string",
"maxLength": 80
},
"style_code": {
"description": "Sneakers: style code from the box or tag",
"type": "string",
"maxLength": 20
},
"size": {
"description": "Sneakers: US size, half sizes allowed (needs size_group)",
"type": "number",
"minimum": 1,
"maximum": 20
},
"size_group": {
"description": "Sneakers: which US size run",
"type": "string",
"enum": [
"Men's",
"Women's",
"Youth"
]
},
"sneaker_condition": {
"description": "Sneakers: condition",
"type": "string",
"enum": [
"New with box",
"New without box",
"Worn once",
"Used"
]
},
"box": {
"description": "Sneakers: comes with the original box",
"type": "boolean"
},
"receipt": {
"description": "Sneakers: comes with proof of purchase",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Only for Trading Cards and Sneakers listings: the facts collectors trade on. Use the card fields for Trading Cards and the sneaker fields for Sneakers."
},
"want_tags": {
"description": "Short tags for what the user wants in exchange",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
},
"want_description": {
"description": "What the user would like in exchange",
"type": "string",
"maxLength": 2000
},
"stated_value_usd": {
"description": "The user's own estimate of its value in US dollars, used to match fair trades",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"kind": {
"description": "offer (default) for something the user has; wanted for something the user is looking for, with want fields describing what they would give",
"type": "string",
"enum": [
"offer",
"wanted"
]
},
"pickup": {
"description": "Can be handed over in person (default true)",
"type": "boolean"
},
"ships": {
"description": "The user will ship it (default false)",
"type": "boolean"
},
"location_city": {
"description": "City shown on the listing",
"type": "string",
"maxLength": 100
},
"draft": {
"description": "true saves it unpublished; publish later with set_listing_status",
"type": "boolean"
}
},
"required": [
"title",
"description",
"type",
"category"
],
"additionalProperties": false
}