---
title: "Scrape oopbuy.com product-search listings"
method: POST
path: "/goods/oopbuy-search"
tags: ["Plugins"]
---

# Scrape oopbuy.com product-search listings

`POST /goods/oopbuy-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/goods/oopbuy-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches oopbuy.com for `keyword` and returns product listings as JSON: `title`, `titleCn`, `price` (in USD), `priceCny`, `monthSold`, `image`, `spu`, `channel`, and a product `url`. Pick the source marketplace with `channel` ('1688', 'taobao', or 'official'), order with `sort`, and page with `page`/`page_size`. Note: oopbuy trademark-blocks brand-name keywords at its own backend. That block is oopbuy's own genuine answer (it returns it as an HTTP 200 too), so we mirror it: brand queries come back as HTTP 200 with `keywordRejected: true` and an empty `results` array, not an error.

## Query parameters

- `keyword` string, required: Search phrase, e.g. 'hoodie' or 'phone case'. oopbuy trademark-blocks brand names (nike, adidas) at its own backend; those come back as a successful HTTP 200 carrying `keywordRejected: true` and an empty `results` array, not an error.
- `channel` string: Source marketplace: '1688' (default), 'taobao', or 'official' (oopbuy's own curated storefront).
- `page` integer: 1-based page number.
- `page_size` integer: Results per page (max 60). The 1688 channel serves at most 50 and Taobao at most 20 per page; a larger value is capped to that.
- `sort` string: Ordering: 'default', 'price_asc', 'price_desc', or 'best_selling'.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').

## Response `200`

Successful scrape. Either a `results` array of listings, or - for a brand/trademark-blocked keyword - `keywordRejected: true` with an empty `results` array (oopbuy's own genuine response).

- unknown

## Other responses

- `422`: Validation Error
- `502`: Search failed (upstream block or proxy failure), or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)