{"openapi":"3.1.0","info":{"title":"Freebox Resale Intelligence & Curb Radar API","version":"1.2.0","description":"Official API and tool definitions for Freebox — providing automated secondary market resale valuations and real-time free curbside listings across 348+ US metros (covering 8,390 cities & towns).","contact":{"name":"Freebox Engineering","url":"https://usefreebox.com/about","email":"support@usefreebox.com"}},"servers":[{"url":"https://usefreebox.com","description":"Production Server"}],"paths":{"/api/worth/{item}":{"get":{"summary":"Get Resale Valuation & Comps for an Item","operationId":"getItemValuation","description":"Returns secondary market resale value range ($low–$high, avg), pawn shop cash offer, flipper profit calculation, demand velocity, and inspection checkpoints for any physical item.","parameters":[{"name":"item","in":"path","required":true,"description":"The item slug or title (e.g. 'kitchenaid-mixer', 'herman-miller-chair', 'dewalt-table-saw')","schema":{"type":"string","example":"kitchenaid-mixer"}}],"responses":{"200":{"description":"Item valuation data found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"item":{"type":"string"},"resale_value_usd":{"type":"object","properties":{"low":{"type":"number"},"average":{"type":"number"},"high":{"type":"number"}}},"pawn_shop_cash_offer_usd":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"}}},"flipper_profit_usd":{"type":"object","properties":{"net_profit":{"type":"number"},"implied_hourly_earnings":{"type":"number"}}},"citation":{"type":"string"}}}}}}}}},"/api/near-me":{"get":{"summary":"Lookup Free Curbside Finds by ZIP Code","operationId":"getNearbyCurbFinds","description":"Returns active zero-dollar curbside listings, moving giveaways, and bulk trash drop alerts within 50–150 miles of a given 5-digit US ZIP code, each tagged with estimated resale value.","parameters":[{"name":"zip","in":"query","required":true,"description":"5-digit US ZIP code","schema":{"type":"string","pattern":"^[0-9]{5}$","example":"98101"}}],"responses":{"200":{"description":"Nearby free items retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"zip":{"type":"string"},"find_count":{"type":"integer"},"total_value":{"type":"number"},"scope":{"type":"string","enum":["metro","radius","national"]},"samples":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"value":{"type":"number"}}}}}}}}}}}}}}