Expanding a search
A standard search returns up to 10 ranked products. Expand runs the same search against a broader candidate set and returns 50+ results, paginated.
In this guide:
- When to expand
- How to expand
- The cost
- What changes (and what doesn’t)
When to expand
- The top 10 are all worth saving. That’s a sign the niche is dense; you want to see more.
- You’re doing a category sweep. A single keyword/category that you want to know top-50 of, not top-10.
- You’re building a shortlist for a partner. PDFs and CSVs export only what you’ve fetched; expand if you want a longer list in the export.
Expanding is rarely the right call on a first search where you’re still tuning filters. Tune first; expand once.
How to expand
On a results page, click Expand to 50+ at the top.
The expand reuses the original search’s parameters — same keyword, same filters, same weights. Only the result count changes.
Cost
Expand costs 2 credits. The original search already cost 1, so the total cost of “search + expand” is 3.
What changes
- Result count — up to 10 → up to 50 (or more, depending on what the catalog returns).
- Pagination — results are paginated 25 per page on the UI; the API returns up to 50 in the underlying
ExpandResponseSchema. - Sort — still by SellerScore descending.
What doesn’t change
- Search parameters — same keyword, marketplace, filters, weights.
- Search UUID — same UUID; the search history shows one entry, not two.
- Snapshot freshness — the metrics are still as of the original search time, not re-fetched. (If you want fresh data, re-run the search instead of expanding it.)
Expand vs re-run
| Expand | Re-run | |
|---|---|---|
| Same UUID | Yes | No (creates a new search) |
| Same parameters | Yes (cannot change) | Yes (defaults to original) |
| Fresh data | No (uses original snapshot data sources) | Yes |
| Cost | 2 credits | 1 credit |
| Use when | You want more from the same snapshot | You want fresh data, parameters might change |
If you want both more results and fresh data, re-run the original search and then expand the new one — it’ll cost 1 + 2 = 3 credits, same as expanding the original, but you’ll have current numbers.