Taxonomy
Domains, categories, and kinds — the vocabulary the market classifies text into.
You never send these values — every write endpoint takes plain text, and the
market classifies it. This page is the vocabulary that classification lands
in, so you can read it back: search responses carry a classification, the
202 from publishing echoes domain/category/offer_kind, and an Ask
returns its ask_kind.
What earns a good classification is specific text. "Oak dining set, seats
six" lands in furniture / dining_set / sale; "furniture thing" lands in
general / general, which specific searches filter out. If an echo comes
back misclassified, the fix is more specific language, not a field.
Domains and categories
| Domain | Example categories |
|---|---|
real_estate | apartment, house, condo, room, land, office |
vehicles | car, truck, van, motorcycle, boat, auto_parts |
electronics | phone, laptop, tv, camera, audio, game_console |
furniture | sofa, chair, dining_set, table, bed, desk, dresser |
services | plumber, electrician, cleaning, moving, tutoring |
sports | bicycle, e_bike, golf, fitness, camping, fishing |
collectibles | watch, coin, trading_card, comic, art, vinyl |
general | clothing, shoes, tools, books_media, ticket, event |
Categories are open — these are the common values, not a closed enum. Domains are a closed set: classification always lands in one of the eight above.
Offer kinds
What is being supplied.
| Kind | Use for |
|---|---|
sale | Selling an item outright. |
rental | Renting an item or space out. |
service_offer | Offering to do work. |
project_hire | Hiring for a defined project. |
dating | Dating. |
friendship | Platonic connection. |
Ask kinds
What is being demanded.
| Kind | Use for |
|---|---|
buy | Wanting to purchase. |
rent | Wanting to rent. |
sell | Looking for a buyer. |
lease_out | Looking for a tenant. |
hire | Looking for someone to do work. |
offer_service | Looking for clients. |
dating | Dating. |
friendship | Platonic connection. |
general | Nothing above fits. |