Where to sell an item on 12 US marketplaces: eligibility, fees, profit, target price, payout timing.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Answer "where should I sell this?" for one item. For each US marketplace: whether it accepts the item under its published policies (prohibited and restricted items, condition rules, approval-only categories), the fees and profit at the expected price, the lowest price that meets an optional profit goal, and when the seller gets paid. Every rule cites the official page. Returns picks (highest profit, best margin, fastest payout), ranked marketplaces, ones needing approval, and excluded ones with reasons. Doesn't model demand or the price buyers will pay.
clothing (Tops, dresses, jeans, jackets, activewear); kids_clothing (Children's and infant apparel); shoes (Boots, heels, sandals, dress shoes); sneakers (Athletic and lifestyle sneakers); handbags (Handbags, totes, backpacks, designer bags); accessories (Belts, wallets, hats, scarves, sunglasses); jewelry (Fine and fashion jewelry); watches (Analog and digital wristwatches (smartwatches count as electronics)); beauty_cosmetics (Makeup, skincare, hair care); fragrance (Perfume, cologne); vitamins_supplements (Vitamins, protein powder, dietary supplements); electronics (Phones, tablets, laptops, headphones, cameras, smartwatches, consoles); video_games_media (Video games, DVDs, Blu-rays, CDs, vinyl); books (Books, textbooks, comics); toys (Toys, board games, LEGO, dolls); trading_cards (Sports and trading card game cards, graded cards); home_decor (Decor, kitchenware, bedding, lamps); furniture (Chairs, tables, dressers, shelving); sporting_goods (Fitness, outdoor, camping, team sports equipment); art (Paintings, prints, sculpture, photography)
Optional: exactly one of profit (USD), margin_percent or roi_percent.
summary (default) returns totals and fee lines; full returns the complete REST response.
Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs.
Seller's cost of the item, in USD. Default 0.
Per-marketplace category, options or shipping values, e.g. {"ebay": {"options": {"store_subscription": "basic"}}, "etsy": {"options": {"offsite_ads_percent": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default
Facts that change eligibility. Etsy only accepts handmade, seller-designed, vintage (20+ years) or craft supplies.
Other per-item costs (packaging, ads, etc.), in USD. Default 0.
Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given.
Seller's shipping label cost, in USD. Default 0.
Expected sale price in USD. Give this, expected_prices or goal.
Per-marketplace expected prices, e.g. {"stockx": 140}.
amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14.
Shipping the buyer pays, in USD. Default 0.
Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http marketplace-fees https://marketplace-fee-calculator-api.huggyworks.workers.dev/mcp
Answer "where should I sell this?" for one item. For each US marketplace: whether it accepts the item under its published policies (prohibited and restricted items, condition rules, approval-only categories), the fees and profit at the expected price, the lowest price that meets an optional profit goal, and when the seller gets paid. Every rule cites the official page. Returns picks (highest profit, best margin, fastest payout), ranked marketplaces, ones needing approval, and excluded ones with reasons. Doesn't model demand or the price buyers will pay.
| Argument | Type | Description |
|---|---|---|
| goal | object | Optional: exactly one of profit (USD), margin_percent or roi_percent. |
| detail | string | summary (default) returns totals and fee lines; full returns the complete REST response. |
| package | object | Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs. |
| sort_by | string | |
| condition* | string | |
| item_cost | number | Seller's cost of the item, in USD. Default 0. |
| item_type* | string | clothing (Tops, dresses, jeans, jackets, activewear); kids_clothing (Children's and infant apparel); shoes (Boots, heels, sandals, dress shoes); sneakers (Athletic and lifestyle sneakers); handbags (Handbags, totes, backpacks, designer bags); accessories (Belts, wallets, hats, scarves, sunglasses); jewelry (Fine and fashion jewelry); watches (Analog and digital wristwatches (smartwatches count as electronics)); beauty_cosmetics (Makeup, skincare, hair care); fragrance (Perfume, cologne); vitamins_supplements (Vitamins, protein powder, dietary supplements); electronics (Phones, tablets, laptops, headphones, cameras, smartwatches, consoles); video_games_media (Video games, DVDs, Blu-rays, CDs, vinyl); books (Books, textbooks, comics); toys (Toys, board games, LEGO, dolls); trading_cards (Sports and trading card game cards, graded cards); home_decor (Decor, kitchenware, bedding, lamps); furniture (Chairs, tables, dressers, shelving); sporting_goods (Fitness, outdoor, camping, team sports equipment); art (Paintings, prints, sculpture, photography) |
| overrides | object | Per-marketplace category, options or shipping values, e.g. {"ebay": {"options": {"store_subscription": "basic"}}, "etsy": {"options": {"offsite_ads_percent": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default |
| attributes | object | Facts that change eligibility. Etsy only accepts handmade, seller-designed, vintage (20+ years) or craft supplies. |
| other_costs | number | Other per-item costs (packaging, ads, etc.), in USD. Default 0. |
| marketplaces | array | Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given. |
| shipping_cost | number | Seller's shipping label cost, in USD. Default 0. |
| expected_price | number | Expected sale price in USD. Give this, expected_prices or goal. |
| expected_prices | object | Per-marketplace expected prices, e.g. {"stockx": 140}. |
| fulfillment_date | string | amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14. |
| shipping_charged | number | Shipping the buyer pays, in USD. Default 0. |
| estimated_sales_tax | number | Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0. |
{
"type": "object",
"required": [
"item_type",
"condition"
],
"properties": {
"goal": {
"type": "object",
"properties": {
"profit": {
"type": "number"
},
"roi_percent": {
"type": "number",
"exclusiveMinimum": -100
},
"margin_percent": {
"type": "number",
"exclusiveMaximum": 100
}
},
"description": "Optional: exactly one of profit (USD), margin_percent or roi_percent.",
"maxProperties": 1,
"minProperties": 1,
"additionalProperties": false
},
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"default": "summary",
"description": "summary (default) returns totals and fee lines; full returns the complete REST response."
},
"package": {
"type": "object",
"required": [
"length_in",
"width_in",
"height_in",
"weight_lb"
],
"properties": {
"width_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"height_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"length_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"maximum": 5000,
"exclusiveMinimum": 0
}
},
"description": "Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs.",
"additionalProperties": false
},
"sort_by": {
"enum": [
"profit",
"margin",
"payout_speed"
],
"type": "string",
"default": "profit"
},
"condition": {
"enum": [
"new",
"new_with_defects",
"used_like_new",
"used",
"for_parts"
],
"type": "string"
},
"item_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's cost of the item, in USD. Default 0."
},
"item_type": {
"enum": [
"clothing",
"kids_clothing",
"shoes",
"sneakers",
"handbags",
"accessories",
"jewelry",
"watches",
"beauty_cosmetics",
"fragrance",
"vitamins_supplements",
"electronics",
"video_games_media",
"books",
"toys",
"trading_cards",
"home_decor",
"furniture",
"sporting_goods",
"art"
],
"type": "string",
"description": "clothing (Tops, dresses, jeans, jackets, activewear); kids_clothing (Children's and infant apparel); shoes (Boots, heels, sandals, dress shoes); sneakers (Athletic and lifestyle sneakers); handbags (Handbags, totes, backpacks, designer bags); accessories (Belts, wallets, hats, scarves, sunglasses); jewelry (Fine and fashion jewelry); watches (Analog and digital wristwatches (smartwatches count as electronics)); beauty_cosmetics (Makeup, skincare, hair care); fragrance (Perfume, cologne); vitamins_supplements (Vitamins, protein powder, dietary supplements); electronics (Phones, tablets, laptops, headphones, cameras, smartwatches, consoles); video_games_media (Video games, DVDs, Blu-rays, CDs, vinyl); books (Books, textbooks, comics); toys (Toys, board games, LEGO, dolls); trading_cards (Sports and trading card game cards, graded cards); home_decor (Decor, kitchenware, bedding, lamps); furniture (Chairs, tables, dressers, shelving); sporting_goods (Fitness, outdoor, camping, team sports equipment); art (Paintings, prints, sculpture, photography)"
},
"overrides": {
"type": "object",
"description": "Per-marketplace category, options or shipping values, e.g. {\"ebay\": {\"options\": {\"store_subscription\": \"basic\"}}, \"etsy\": {\"options\": {\"offsite_ads_percent\": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default",
"propertyNames": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
]
},
"additionalProperties": {
"type": "object",
"properties": {
"options": {
"type": "object"
},
"category": {
"type": "string"
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
}
},
"additionalProperties": false
}
},
"attributes": {
"type": "object",
"properties": {
"handmade": {
"type": "boolean"
},
"craft_supply": {
"type": "boolean"
},
"vintage_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1000
},
"seller_designed": {
"type": "boolean"
}
},
"description": "Facts that change eligibility. Etsy only accepts handmade, seller-designed, vintage (20+ years) or craft supplies.",
"additionalProperties": false
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Other per-item costs (packaging, ads, etc.), in USD. Default 0."
},
"marketplaces": {
"type": "array",
"items": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
],
"type": "string"
},
"minItems": 1,
"description": "Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given.",
"uniqueItems": true
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's shipping label cost, in USD. Default 0."
},
"expected_price": {
"type": "number",
"maximum": 1000000,
"description": "Expected sale price in USD. Give this, expected_prices or goal.",
"exclusiveMinimum": 0
},
"expected_prices": {
"type": "object",
"description": "Per-marketplace expected prices, e.g. {\"stockx\": 140}.",
"additionalProperties": {
"type": "number"
}
},
"fulfillment_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Shipping the buyer pays, in USD. Default 0."
},
"estimated_sales_tax": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0."
}
},
"additionalProperties": false
}Calculate the seller fees, net payout, profit, margin and ROI for selling one item at a given price on one US marketplace, itemized fee by fee from the marketplace's official fee schedule. For Amazon FBA and Walmart WFS, include package dimensions to add fulfillment fees.
| Argument | Type | Description |
|---|---|---|
| detail | string | summary (default) returns totals and fee lines; full returns the complete REST response. |
| options | object | Marketplace-specific options (e.g. ebay store_subscription, etsy offsite_ads_percent). See list_marketplaces for names and values. |
| package | object | Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs. |
| category | string | Fee category; valid values depend on marketplace. amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default |
Rank every supported US marketplace (or a chosen subset) by the profit the seller keeps when selling one item at the same price. Returns the best marketplace, each marketplace's fees, payout and margin, and any marketplaces skipped or rejected with the reason.
| Argument | Type | Description |
|---|---|---|
| detail | string | summary (default) returns totals and fee lines; full returns the complete REST response. |
| package | object | Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs. |
| item_cost | number | Seller's cost of the item, in USD. Default 0. |
| overrides | object | Per-marketplace category, options or shipping values, e.g. {"ebay": {"options": {"store_subscription": "basic"}}, "etsy": {"options": {"offsite_ads_percent": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default |
Find the lowest list price on each US marketplace that reaches a goal: a profit in USD, a profit margin percent, or an ROI percent. Results are sorted from cheapest required price; marketplaces where the goal can't be reached are listed with the reason.
| Argument | Type | Description |
|---|---|---|
| detail | string | summary (default) returns totals and fee lines; full returns the complete REST response. |
| target* | object | Exactly one of profit, margin_percent or roi_percent. |
| package | object | Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs. |
| item_cost | number | Seller's cost of the item, in USD. Default 0. |
| overrides | object | Per-marketplace category, options or shipping values, e.g. {"ebay": {"options": {"store_subscription": "basic"}}, "etsy": {"options": {"offsite_ads_percent": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default |
List the supported US marketplaces with their valid categories, options, whether package dimensions are needed, the official fee pages used as sources and the date each was verified. Call this first to find valid category and option values.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 14, 2026.
| item_cost | number | Seller's cost of the item, in USD. Default 0. |
| sale_price* | number | Item price the buyer pays, in USD, excluding shipping and tax. |
| marketplace* | string | amazon_fbm = Amazon (Fulfilled by Merchant); amazon_fba = Amazon (Fulfilled by Amazon); walmart = Walmart Marketplace; walmart_wfs = Walmart Marketplace (Walmart Fulfillment Services); ebay = eBay; tiktok_shop = TikTok Shop (US); etsy = Etsy; facebook_marketplace = Facebook Marketplace; poshmark = Poshmark; mercari = Mercari; depop = Depop (US); stockx = StockX (Verified Marketplace) |
| other_costs | number | Other per-item costs (packaging, ads, etc.), in USD. Default 0. |
| shipping_cost | number | Seller's shipping label cost, in USD. Default 0. |
| fulfillment_date | string | amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14. |
| shipping_charged | number | Shipping the buyer pays, in USD. Default 0. |
| estimated_sales_tax | number | Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0. |
{
"type": "object",
"required": [
"marketplace",
"sale_price"
],
"properties": {
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"default": "summary",
"description": "summary (default) returns totals and fee lines; full returns the complete REST response."
},
"options": {
"type": "object",
"description": "Marketplace-specific options (e.g. ebay store_subscription, etsy offsite_ads_percent). See list_marketplaces for names and values."
},
"package": {
"type": "object",
"required": [
"length_in",
"width_in",
"height_in",
"weight_lb"
],
"properties": {
"width_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"height_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"length_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"maximum": 5000,
"exclusiveMinimum": 0
}
},
"description": "Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs.",
"additionalProperties": false
},
"category": {
"type": "string",
"default": "default",
"description": "Fee category; valid values depend on marketplace. amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default"
},
"item_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's cost of the item, in USD. Default 0."
},
"sale_price": {
"type": "number",
"maximum": 1000000,
"description": "Item price the buyer pays, in USD, excluding shipping and tax.",
"exclusiveMinimum": 0
},
"marketplace": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
],
"type": "string",
"description": "amazon_fbm = Amazon (Fulfilled by Merchant); amazon_fba = Amazon (Fulfilled by Amazon); walmart = Walmart Marketplace; walmart_wfs = Walmart Marketplace (Walmart Fulfillment Services); ebay = eBay; tiktok_shop = TikTok Shop (US); etsy = Etsy; facebook_marketplace = Facebook Marketplace; poshmark = Poshmark; mercari = Mercari; depop = Depop (US); stockx = StockX (Verified Marketplace)"
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Other per-item costs (packaging, ads, etc.), in USD. Default 0."
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's shipping label cost, in USD. Default 0."
},
"fulfillment_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Shipping the buyer pays, in USD. Default 0."
},
"estimated_sales_tax": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0."
}
},
"additionalProperties": false
}| sale_price* | number | Item price the buyer pays, in USD, excluding shipping and tax. |
| other_costs | number | Other per-item costs (packaging, ads, etc.), in USD. Default 0. |
| marketplaces | array | Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given. |
| shipping_cost | number | Seller's shipping label cost, in USD. Default 0. |
| fulfillment_date | string | amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14. |
| shipping_charged | number | Shipping the buyer pays, in USD. Default 0. |
| estimated_sales_tax | number | Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0. |
{
"type": "object",
"required": [
"sale_price"
],
"properties": {
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"default": "summary",
"description": "summary (default) returns totals and fee lines; full returns the complete REST response."
},
"package": {
"type": "object",
"required": [
"length_in",
"width_in",
"height_in",
"weight_lb"
],
"properties": {
"width_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"height_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"length_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"maximum": 5000,
"exclusiveMinimum": 0
}
},
"description": "Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs.",
"additionalProperties": false
},
"item_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's cost of the item, in USD. Default 0."
},
"overrides": {
"type": "object",
"description": "Per-marketplace category, options or shipping values, e.g. {\"ebay\": {\"options\": {\"store_subscription\": \"basic\"}}, \"etsy\": {\"options\": {\"offsite_ads_percent\": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default",
"propertyNames": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
]
},
"additionalProperties": {
"type": "object",
"properties": {
"options": {
"type": "object"
},
"category": {
"type": "string"
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
}
},
"additionalProperties": false
}
},
"sale_price": {
"type": "number",
"maximum": 1000000,
"description": "Item price the buyer pays, in USD, excluding shipping and tax.",
"exclusiveMinimum": 0
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Other per-item costs (packaging, ads, etc.), in USD. Default 0."
},
"marketplaces": {
"type": "array",
"items": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
],
"type": "string"
},
"minItems": 1,
"description": "Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given.",
"uniqueItems": true
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's shipping label cost, in USD. Default 0."
},
"fulfillment_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Shipping the buyer pays, in USD. Default 0."
},
"estimated_sales_tax": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0."
}
},
"additionalProperties": false
}| other_costs | number | Other per-item costs (packaging, ads, etc.), in USD. Default 0. |
| marketplaces | array | Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given. |
| shipping_cost | number | Seller's shipping label cost, in USD. Default 0. |
| fulfillment_date | string | amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14. |
| shipping_charged | number | Shipping the buyer pays, in USD. Default 0. |
| estimated_sales_tax | number | Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0. |
{
"type": "object",
"required": [
"target"
],
"properties": {
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"default": "summary",
"description": "summary (default) returns totals and fee lines; full returns the complete REST response."
},
"target": {
"type": "object",
"properties": {
"profit": {
"type": "number",
"description": "Profit goal in USD."
},
"roi_percent": {
"type": "number",
"description": "Profit as a percent of total costs. Needs item_cost, shipping_cost or other_costs.",
"exclusiveMinimum": -100
},
"margin_percent": {
"type": "number",
"description": "Profit as a percent of revenue (below 100).",
"exclusiveMaximum": 100
}
},
"description": "Exactly one of profit, margin_percent or roi_percent.",
"maxProperties": 1,
"minProperties": 1,
"additionalProperties": false
},
"package": {
"type": "object",
"required": [
"length_in",
"width_in",
"height_in",
"weight_lb"
],
"properties": {
"width_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"height_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"length_in": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"maximum": 5000,
"exclusiveMinimum": 0
}
},
"description": "Packaged unit dimensions (inches) and unit weight (pounds), used to determine the fulfillment size tier, dimensional weight (L x W x H / 139) and shipping weight. Required for amazon_fba and walmart_wfs.",
"additionalProperties": false
},
"item_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's cost of the item, in USD. Default 0."
},
"overrides": {
"type": "object",
"description": "Per-marketplace category, options or shipping values, e.g. {\"ebay\": {\"options\": {\"store_subscription\": \"basic\"}}, \"etsy\": {\"options\": {\"offsite_ads_percent\": 15}}}. Categories: amazon_fbm: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | amazon_fba: default, 3d_printers, amazon_device_accessories, appliances_compact, appliances_full_size, automotive, baby, backpacks_handbags_luggage, base_equipment_power_tools, beauty, industrial, clothing_accessories, computers, consumer_electronics, electronics_accessories, eyewear, footwear, furniture, gift_cards, grocery, home_kitchen, jewelry, lawn_garden, lawn_mowers_snow_throwers, mattresses, media, merchant_fulfilled_services, musical_instruments_av, office_products, pet_supplies, pet_veterinary_diets, sports_outdoors, tires, tools_home_improvement, toys_games, video_games_accessories, video_game_consoles, watches | walmart: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | walmart_wfs: default, apparel, appliances_compact, appliances_major, automotive, baby, base_power_tools, beauty, books, camera_photo, collectibles, consumer_electronics, electronics_accessories, furniture, grocery, home_kitchen_decor_garden, industrial_scientific, jewelry_precious_metals, luggage_travel, music, musical_instruments, office_products, printer_cartridges, outdoor_power_tools, outdoors_sports, outdoor_optics, personal_computers, pet_supplies, plumbing_hvac, shoes_handbags_backpacks_sunglasses, software_video_games, tires_wheels, tools_home_improvement, toys_games, video_dvd, video_game_consoles, watches | ebay: default, electronics, clothing, books_media, vinyl_records, guitars, jewelry, watches, handbags, athletic_shoes | tiktok_shop: default, jewelry_precious, jewelry_other, collectibles, pre_owned | etsy: default | facebook_marketplace: default | poshmark: default | mercari: default | depop: default | stockx: default",
"propertyNames": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
]
},
"additionalProperties": {
"type": "object",
"properties": {
"options": {
"type": "object"
},
"category": {
"type": "string"
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Override for this marketplace."
}
},
"additionalProperties": false
}
},
"other_costs": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Other per-item costs (packaging, ads, etc.), in USD. Default 0."
},
"marketplaces": {
"type": "array",
"items": {
"enum": [
"amazon_fbm",
"amazon_fba",
"walmart",
"walmart_wfs",
"ebay",
"tiktok_shop",
"etsy",
"facebook_marketplace",
"poshmark",
"mercari",
"depop",
"stockx"
],
"type": "string"
},
"minItems": 1,
"description": "Limit to these marketplaces. Default: all. amazon_fba and walmart_wfs are skipped unless package is given.",
"uniqueItems": true
},
"shipping_cost": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Seller's shipping label cost, in USD. Default 0."
},
"fulfillment_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "amazon_fba only: ship date (YYYY-MM-DD) that selects the FBA rate card. Defaults to today (UTC). Range 2026-01-15 to 2027-10-14."
},
"shipping_charged": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Shipping the buyer pays, in USD. Default 0."
},
"estimated_sales_tax": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Sales tax collected from the buyer, in USD (some marketplaces charge fees on it). Default 0."
}
},
"additionalProperties": false
}