Live

search_merchants

shop.app

Searches merchant records extracted from a category page feed on https://shop.app. Returns paginated merchants with handles, IDs, and review analytics, plus optional review-count and rating filters.

Marketplace Reviews & Ratings

Parameters7

Runs12

Updated8d ago

Degraded12 runs · 83.3% succeeded

30 days ago90 days agoranfailednot checkedtoday

Playground

GETsearch_merchants GETget_featured_products GETget_product_details GETsearch_autocomplete_suggestions GETlist_categories GETlist_merchant_products_by_sales GETget_merchant_profile

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

Parameters

category_slugstr= beauty

pageint= 1

page_sizeint= 10

min_review_countint= 0

max_review_countint= 1000000000

min_ratingfloat= 0.0

max_ratingfloat= 5.0

Need another parameter? Ask the agent →

Waiting on your first callSet the parameters on the left and test it — the real response shows up right here.

What is search_merchants?

Searches merchant records extracted from a category page feed on https://shop.app. Returns paginated merchants with handles, IDs, and review analytics, plus optional review-count and rating filters. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass category_slug, page, page_size, min_review_count, max_review_count, min_rating, max_rating and get the result back without maintaining a scraper.

Response

{
  "page": 0,
  "filters": {},
  "merchants": [
    {}
  ],
  "page_size": 0,
  "category_id": "<string>",
  "total_pages": 0,
  "category_name": "<string>",
  "category_slug": "<string>",
  "returned_count": 0,
  "total_merchants": 0
}

Call it

curl --location 'https://us-prod.notte.cc/functions/66d0b4ab-2f99-462b-97d1-5d32e71f31c6/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "66d0b4ab-2f99-462b-97d1-5d32e71f31c6",
    "variables": {
        "category_slug": "beauty",
        "page": 1,
        "page_size": 10,
        "min_review_count": 0,
        "max_review_count": 1000000000,
        "min_rating": 0.0,
        "max_rating": 5.0
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt

Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="66d0b4ab-2f99-462b-97d1-5d32e71f31c6") — the "search_merchants" function, which searches merchant records extracted from a category page feed on https://shop.app. Returns paginated merchants with handles, IDs, and review analytics, plus optional review-count and rating filters..

It takes category_slug (str), page (int), page_size (int), min_review_count (int), max_review_count (int), min_rating (float), max_rating (float). Return the result as structured JSON.