ScrapeUnblocker Documentation

The oopbuy Search plugin turns an oopbuy.com keyword search into structured JSON. oopbuy is a China buying-agent storefront that fronts 1688, Taobao and its own curated catalog - give the plugin a product term and it returns the matching listings in about a second, each with title (English and Chinese), USD and CNY price, monthly sales count, image and a product-detail link. Pick the source marketplace with channel, order the results with sort, and walk pages with page / page_size.

Try it in the dashboard first: app.scrapeunblocker.com/dashboard/plugins. You get a live results view plus a copy-paste snippet.

Endpoint

POST /goods/oopbuy-search

Field	Required	Notes
`keyword`	yes	Generic product term, e.g. `hoodie` or `phone case`. Brand names (`nike`, `adidas`) are trademark-blocked by oopbuy itself; those come back as a successful `200` with `keywordRejected: true` and an empty `results` array (see below), not an error.
`channel`	no	Source marketplace: `1688` (default), `taobao`, or `official` (oopbuy’s own curated storefront).
`page`	no	Page number, default `1`.
`page_size`	no	Results per page, default `20`, max `60`.
`sort`	no	`default`, `price_asc`, `price_desc`, or `best_selling`.
`proxy_country`	no	Exit-IP country (ISO-2, e.g. `US`, `DE`).

curl -X POST "https://api.scrapeunblocker.com/goods/oopbuy-search?keyword=hoodie&channel=1688&sort=best_selling&page=1&page_size=20" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

from scrapeunblocker import Client

su = Client()  # reads SCRAPEUNBLOCKER_KEY

results = su.oopbuy_search(
    keyword="hoodie", channel="1688",
    sort="best_selling", page=1, page_size=20,
)

import { ScrapeUnblockerClient } from "scrapeunblocker";

const su = new ScrapeUnblockerClient(); // reads SCRAPEUNBLOCKER_KEY

const results = await su.oopbuySearch({
  keyword: "hoodie", channel: "1688",
  sort: "best_selling", page: 1, page_size: 20,
});

use ScrapeUnblocker\Client;

$su = new Client(); // reads SCRAPEUNBLOCKER_KEY

$results = $su->oopbuySearch([
    'keyword' => 'hoodie', 'channel' => '1688',
    'sort' => 'best_selling', 'page' => 1, 'page_size' => 20,
]);

require "scrapeunblocker"

su = ScrapeUnblocker::Client.new # reads SCRAPEUNBLOCKER_KEY

results = su.oopbuy_search(
  keyword: "hoodie", channel: "1688",
  sort: "best_selling", page: 1, page_size: 20
)

Response

A JSON object with a results array plus totals:

{
  "keyword": "hoodie",
  "channel": "1688",
  "total": 48210,
  "pages": 2411,
  "resultsCollected": 20,
  "results": [
    {
      "spu": "778432112056",
      "channel": "1688",
      "title": "Autumn and winter fleece-lined hoodie, loose fit",
      "titleCn": "秋冬加绒连帽卫衣宽松",
      "price": 4.12,
      "originalPrice": 5.6,
      "priceCny": 29.9,
      "monthSold": 12000,
      "image": "https://cbu01.alicdn.com/img/ibank/....jpg",
      "url": "https://oopbuy.com/product/1688/778432112056"
    }
  ]
}

Field	Notes
`spu`	Product ID on the source marketplace.
`channel`	Marketplace the item comes from (`1688`, `taobao`, `official`).
`title`	Product title in English.
`titleCn`	Original Chinese title.
`price`	Current price in USD.
`originalPrice`	Pre-discount price in USD, or `null` if not discounted.
`priceCny`	Current price in CNY.
`monthSold`	Units sold in the last month, as an integer.
`image`	Product image URL.
`url`	oopbuy product-detail page URL.

Brand-blocked keywords

oopbuy trademark-blocks brand-name searches (nike, adidas, …) at its own backend and returns no listings for them, for every caller including its own website. That is oopbuy’s genuine answer, not a failure of the scrape - oopbuy itself serves it as an HTTP 200 - so the plugin mirrors it: a successful 200 whose body carries keywordRejected: true and an empty results array. Branch on the keywordRejected field, not on an HTTP status code, and swap in a generic product term.

{
  "keyword": "nike",
  "channel": "1688",
  "keywordRejected": true,
  "reason": "brand_trademark_filter",
  "total": 0,
  "pages": 0,
  "resultsCollected": 0,
  "results": [],
  "notice": "oopbuy trademark-blocks brand-name keywords (nike, adidas, ...) at its own backend and serves no listings for them, for every caller including its own website. Use a generic product term."
}

Errors

Status	Meaning
`502`	Search failed upstream.
`504`	Search timed out.

What you can build

Sourcing and price research - find the cheapest 1688/Taobao suppliers for a product category, in USD, without reading Chinese.
Best-seller monitoring - track monthSold for a niche over time and spot trending products early.
Catalog enrichment - map your SKUs to Chinese-marketplace listings with images, prices, and detail links.
Reseller tooling - power a product-search UI for a buying-agent or dropshipping front end.

Get Started

No-code area

Plugins

AI Assistants

Guides

Code Examples

oopbuy Search plugin

Endpoint

Response

Brand-blocked keywords

Errors

What you can build

Next steps

Open the plugins

Get an API key

​Endpoint

​Response

​Brand-blocked keywords

​Errors

​What you can build

​Next steps

Open the plugins

Get an API key

Endpoint

Response

Brand-blocked keywords

Errors

What you can build

Next steps