page | object | required | Pagination & sorting: {page, pageSize, orders[]} Example: {
"pageSize": 10,
"page": 1
} |
page.page | integer | optional | Page number, starting from 1, default 1 Example: 1 |
page.pageSize | integer | optional | Items per page, default 20 Example: 20 |
page.orders | array | optional | Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending) Example: [
{
"direction": "DESC",
"field": "searchVolume"
}
] |
keywords | array | optional | Keyword array (max 1000), used with matchType Example: [] |
matchType | integer | optional | Keyword match mode: 0 exact, 1 fuzzy Example: 1 |
searchDate | string | optional | Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data Example: 2026-01-01 |
categories | array | optional | Category ID array (max 1000) Example: [] |
searchVolume | object | optional | Search volume range {min,max} Example: {
"min": 1
} |
searchChange30 | object | optional | 30-day search change range {min,max} Example: {
"min": 1
} |
monthlySales | object | optional | Monthly sales range {min,max} Example: {
"min": 1
} |
monthlyRevenue | object | optional | Monthly revenue range {min,max} Example: {
"min": 1
} |
price | object | optional | Price range {min,max} Example: {
"min": 1
} |
productViews | object | optional | Product views range {min,max} Example: {
"min": 1
} |
products | object | optional | Product count range {min,max} Example: {
"min": 1
} |
volume | object | optional | Volume range {min,max} Example: {
"min": 1
} |
marketSpace | object | optional | Market space range {min,max} Example: {
"min": 1
} |
conversionSharing | object | optional | Conversion concentration range {min,max} Example: {
"min": 1
} |
reviews | object | optional | Review count range {min,max} Example: {
"min": 1
} |
ratings | object | optional | Rating range {min,max} Example: {
"min": 1
} |
sellers | object | optional | Seller count range {min,max} Example: {
"min": 1
} |
weight | object | optional | Weight range {min,max} Example: {
"min": 1
} |
uId | string | optional | User ID Example: example-id |
memberId | string | optional | Member ID (a unique member identifier; data is attributed to memberId) Example: example-id |