# Search

> Search Amazon by keyword or search URL and get ranked product listings, filters and related searches with the Easyparser Real-Time API.

Source: https://docs.easyparser.com/real-time-integration/search

The Search operation (`SEARCH`) returns the products that appear on an Amazon search results page, in the order Amazon ranks them. You send either a `keyword` or the `url` of an Amazon search results page, plus the marketplace `domain`.

## When to use

- Track where your products rank for a keyword, and how the ranking changes over time.
- Monitor which competitors and sponsored listings appear for the search terms you care about.
- Collect the product list for a niche or category, then fetch full data for each ASIN with the [Detail](/real-time-integration/detail) operation.
- Research keywords and build SEO or listing optimization tools by comparing prices, ratings and sponsored placements across search terms.
- Run large keyword lists with the [Bulk API](/bulk-integration/overview) instead of one request per keyword.

## What the response includes

- Ranked product listings (`search_results`): position, ASIN, title, brand, link and thumbnail image ID.
- Price data: current price, other listed prices such as the list price, and the lowest price from other offers.
- Ratings and review counts, recent purchase activity ("bought in past month") and color variant counts.
- Listing flags: `is_sponsored` for ads and `is_prime` for Prime eligibility.
- The filters Amazon shows in the sidebar (`refinements`), such as brand, department, price and customer reviews, with the IDs you can send back in the `refinements` parameter.
- Related searches and the delivery location used for the results.

![Amazon search results page showing ranked products with prices, ratings and sidebar filters, the data the Search operation returns](https://docs.easyparser.com/media/images/59a90375c54f.png)

*The Search operation returns the data shown on an Amazon search results page.*

See the [Search response](/real-time-integration/search/response) for every field.

## Credit cost

1 credit per results page (`max_page - min_page + 1`), with at most 5 pages (5 credits) per request. See [Credit Consumption](/essentials/credit-consumption).

## Reference

- [Request](/real-time-integration/search/request): parameters and examples
- [Response](/real-time-integration/search/response): fields and a sample response