Search Egonex listings
search_offersSearch listings on Egonex, a marketplace where individual people sell things and services directly. Use it when your user wants to buy, hire, book, rent or commission something from a person rather than a store, for example:
items, new or used: cameras and lenses, phones, laptops, bikes, furniture, clothing, collectibles, instruments, gear;
lessons and coaching: languages, music, tutoring and test prep, fitness, cooking, art, coding;
services in person: photography, repairs (bikes, electronics, film cameras), cleaning, moving help, pet care, babysitting, beauty, tours;
online and freelance work: design, writing and editing, translation, software, marketing, consulting, video editing;
digital goods, tickets, handmade and custom work. Each result is one listing with a price and unit (per item, package, hour, session, day, week, month, night, person or project; USD), how it is delivered (in person in a city, online, or either), for physical items its condition (new, like_new, good, fair, for_parts), brand / model / gtin when the seller gave them, and ships = true when the seller posts it (your user enters the shipping address when paying on Egonex, or you pass it to pay_order when you pay), delivery_days when the seller states a usual delivery time (days to ship for posted items), up to 4 photo URLs, the listing's own page, ask_url / order_url links a person can open, and the seller: their public page, seller.answers_questions (true = ask_seller gets an answer right away), seller.trusted (true = Egonex's Trusted badge, given automatically for the seller's recent trading on Egonex, not set by the seller) and, when there are 3 or more, seller.orders_completed; seller.review_count, seller.positive_count and seller.negative_count appear when the seller has counted buyer reviews (each review is positive or negative), and seller.positive_rate (0 to 100, rounded down) once there are 10 or more. Results are ranked by how well they match the query words (rarer words count more; listings that match only common words are left out); among results that match equally well (and are equally close, for in-person services), sellers with more positive and fewer negative counted buyer reviews come first, and sellers with no reviews sit in the middle; each result's relevance says whether the listing itself (its title and description, not the store's name or intro) matches all or only some words, and matched_words / missing_words say which. Online, remote and in person in query never bring in a listing by themselves: among equally good matches, listings whose title says it come first, then those delivered that way; a listing that is neither counts as some. Only the first 12 search words of query are used (filler words like for, near or cheap don't count, nor do single letters or two-letter words in lowercase: write abbreviations in capitals, such as QA or IT); the rest come back in unused_words. When nothing matches, the response says so and lists the categories that have listings; a search within a category or a store returns that category's or store's other listings instead, marked other_filters. query can be in any language. When it isn't English, Egonex also searches an English translation of it; when it has words too short to search, ends with a place (and city is empty) or matches nothing, Egonex searches a rewrite instead. searched_as says what was searched. Put the place in city, not in query (listing cities are not matched against query words): in-person listings in that city come first, then those nearby (same metro area or within about 30 miles), and add the state when several places share the name (Portland, OR). Online, either-way and shipped listings are always included, and in-person listings without a city that don't ship come back with city_unknown = true (ask the seller before suggesting one to someone far away). Use store to list one seller's storefront. Each listing has availability (in_stock; sold-out listings are left out of results) and stock_left when only 1 to 3 are left. When you suggest a listing to your user, give them its url (the listing's own page) so they can open it. No account or API key is needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City for in-person listings, e.g. "San Francisco" or "Portland, OR". In-person listings in that city come first, then those nearby (same metro area or within about 30 miles); listings done only in person elsewhere are left out. Add the state when several places share the name. In-person listings without a city are kept and marked city_unknown (unless they ship); online, either-way and shipped listings are always included and rank after local ones. | |
| limit | No | ||
| query | No | What your user wants, in a few words, e.g. "spanish lessons for kids", "used fujifilm camera", "logo design", "road bike tune-up". Matched as whole words and their word forms (lesson / lessons, colorized / colorization) against listing titles and descriptions; a word naming a category (pets, electronics, fashion, clothing, jewelry, makeup, furniture, toys, baby, camping, hobbies, crafts, books, food, tickets, rentals, templates, video, or the same in Chinese, Japanese or Korean) also matches listings in that category. Store names, intros and listing cities are not matched (put places in city). Rarer words count more, and listings that match only common words are left out. Online, remote and in person never bring in a listing by themselves: among equally good matches, listings whose title says it come first, then those delivered that way (either-way listings count as both). To keep only one kind use delivery, which is exact: delivery=remote leaves out either-way listings. Only the first 12 search words are used, so put the most important first. Write abbreviations in capitals (QA, PR, IT). | |
| store | No | Only this seller's storefront (the store name after shop.egonex.ai/@). | |
| offset | No | ||
| category | No | One category. Goods: electronics (electronics & accessories), fashion (clothing & shoes), jewelry (jewelry, bags & accessories), beauty (beauty & personal care), home (home & living), toys (toys & games), baby (baby & maternity), sports (sports & outdoor gear), hobbies (collectibles & hobbies), art (art, handmade & craft supplies), pets (pet supplies), books (books, music & movies), food (food & drinks). Services: lessons (lessons & tutoring), local (local services: repairs, cleaning, moving, pet care, babysitting, beauty, photography), creative (design, writing, translation, video, music), professional (software, AI setup, marketing, legal, accounting). digital (templates, e-books, courses, apps, AI agent skills, media files), rentals (tickets & vouchers), other. | |
| delivery | No | onsite = in person only, remote = online only, hybrid = either. | |
| condition | No | Physical items: the lowest condition your user accepts (new > like_new > good > fair > for_parts); like_new returns new and like_new. Listings that don't state a condition are included. | |
| max_price | No | Highest price in USD (per the listing's unit). | |
| min_price | No | Lowest price in USD (per the listing's unit). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | How the results were found, when not every word matched or nothing did, or not every word was used. | |
| total | Yes | How many listings match in all. | |
| offers | Yes | Listings on this page. | |
| browse_url | No | When nothing matched: the sellers directory for people. | |
| categories | No | When nothing matched: categories that have listings. | |
| next_offset | Yes | Pass as offset for the next page; null = no more. | |
| searched_as | No | Only when Egonex searched a rewrite of query (it isn't in English, has words too short to search, ends with a place, or nothing matched): what was searched. matched_words and missing_words are in the words of the search that found the listing: the rewrite, or, for a query that isn't in English, the query as written. | |
| unused_words | No | Words of query that were not used: only the first 12 search words count. Search again with them if they matter. |