# 1688 Price History & Daily Orders Tracker: China Sourcing API (`dev00/1688-price-history-orders`) Actor

Track historical 1688 wholesale prices, 30/90/365-day lowest prices, and daily sales orders volume from 1688 product links or offer SKU IDs.

- **URL**: https://apify.com/dev00/1688-price-history-orders.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 operational query events

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 1688 Price History & Daily Orders Tracker: China Sourcing API

[![Rating](https://img.shields.io/badge/Rating-★★★★★-yellow)](#)
[![Speed](https://img.shields.io/badge/Speed-~250ms%20Ultra--Fast-brightgreen)](#)
[![Pricing](https://img.shields.io/badge/Pricing-🔥%20Competitive-red)](#)
[![Compliance](https://img.shields.io/badge/Status-100%25%20Operational-brightgreen)](#)

### Introduction & Core Capabilities

The **1688 Price History & Daily Orders Tracker: China Sourcing API** provides automated track historical 1688 wholesale prices, 30/90/365-day lowest prices, and daily sales orders volume from 1688 product links or offer sku ids.. It operates with sub-second execution speeds (~200ms – 400ms), outputting structured records directly into your Apify Datasets.

Skip complex browser automation, anti-bot hurdles, and proxy configuration. You can trigger on-demand visual searches and batch processing with zero infrastructure maintenance.

***

### Competitor Comparison Table

| Feature | 1688 Price History & Daily Orders Tracker: China Sourcing API | AliPrice 1688 Extension | 1688 DataHub API |
| :--- | :--- | :--- | :--- |
| **Response Latency** | **~250ms (Global Edge CDN)** | 2,500ms – 5,000ms | 3,000ms – 6,000ms |
| **Unit Cost** | **$0.005 / query ($5 / 1k)** | $0.02 – $0.05 / query | $0.03 – $0.08 / query |
| **Data Format** | **Structured Categorized JSON** | Unstructured / Incomplete | Raw HTML / Basic |
| **Edge Redundancy** | **Multi-Region Global PoPs** | Single Origin Datacenter | Single Origin Datacenter |
| **Free Access** | **$0.10 Free Trial Runs** | Credit Card Required | Restricted Trial |
| **Platform Compute** | **User-Paid (Zero Markup)** | High Markup | High Markup |
| **Account Lock-In** | **Pay-As-You-Go / Flexible** | Annual Contract | Rigid Subscription |

***

### Common Use Cases

- **Automated 1688 Price History Orders Pipeline Ingestion:** Ingest structured records directly into downstream databases, analytics lakes, and custom enterprise dashboards using `link`, `day`, `currency`.
- **Autonomous AI Agent & LLM Tool Augmentation:** Connect schema-validated JSON outputs directly into LangChain, AutoGen, and CrewAI loops as deterministic tools.
- **High-Throughput Batch Processing:** Execute concurrent automated runs across hundreds of target entities without IP throttling, session drops, or bot hurdles.
- **Continuous Monitoring & Event Webhooks:** Trigger automated downstream workflows in Make, Zapier, and n8n whenever new records, changes, or status shifts are detected.
- **Competitive Intelligence & Market Research:** Extract high-fidelity historical and real-time metrics to power quantitative models, trend analysis, and decision-making.

***

### Execution Modes

1. **Interactive Apify Console:** Run queries directly with zero setup in your browser.
2. **Programmatic Node.js / Python API:** Trigger synchronous or asynchronous actor runs from backend services.
3. **Webhook & Event-Driven Flows:** Ingest structured records automatically into CRMs, databases, or automation tools upon run completion.
4. **Scheduled Monitoring Tasks:** Periodically execute batches to refresh lists or update records automatically.

***

### API & Actor Code Examples

#### 1. Apify JavaScript SDK (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN',
});

const input = {
  "link": "https://detail.1688.com/offer/780923930086.html",
  "day": 90,
  "currency": "CNY"
};

const run = await client.actor('1688-price-history-orders').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log('Results:', items);
```

#### 2. Apify Python SDK (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
  "link": "https://detail.1688.com/offer/780923930086.html",
  "day": 90,
  "currency": "CNY"
}

run = client.actor("1688-price-history-orders").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

***

### Full Concrete JSON Payloads

#### HTTP 200 (Success)

```json
{
  "success": true,
  "sku_id": "780923930086",
  "product_url": "https://detail.1688.com/offer/780923930086.html",
  "currency": "CNY",
  "day_range": 90,
  "lowest_price": 0.03,
  "current_price": 0.03,
  "latest_total_orders": 3219900,
  "total_price_points": 27,
  "total_order_points": 35,
  "price_tracking": [
    {
      "price": 0.03,
      "original_price": 0.0,
      "lowest_price": 0.03,
      "price_symbol": "\u00a50.03",
      "timestamp": 1784714400,
      "date": "2026-07-22",
      "datetime": "2026-07-22T10:00:00.000Z"
    },
    {
      "price": 0.03,
      "original_price": 0.0,
      "lowest_price": 0.03,
      "price_symbol": "\u00a50.03",
      "timestamp": 1785081600,
      "date": "2026-07-26",
      "datetime": "2026-07-26T16:00:00.000Z"
    }
  ],
  "orders_history": [
    {
      "orders": 12500,
      "price": 0.03,
      "price_symbol": "\u00a50.03",
      "timestamp": 1784714400,
      "date": "2026-07-22",
      "datetime": "2026-07-22T10:00:00.000Z"
    },
    {
      "orders": 3376591,
      "price": 0.03,
      "price_symbol": "\u00a50.03",
      "timestamp": 1785265200,
      "date": "2026-07-28",
      "datetime": "2026-07-28T19:00:00.000Z"
    }
  ]
}
```

#### HTTP 400 (Bad Request / Missing Parameters)

```json
{
  "success": false,
  "error": "Required parameter is missing or invalid.",
  "code": "missing_parameter"
}
```

#### HTTP 429 (Rate Limit / Concurrency Exceeded)

```json
{
  "success": false,
  "error": "Account concurrency limit reached. Please back off or scale compute units.",
  "code": "rate_limit_exceeded"
}
```

#### HTTP 500 (Upstream Error)

```json
{
  "success": false,
  "error": "Upstream service error encountered. Automatic edge retry failed.",
  "code": "upstream_error"
}
```

***

### Input Parameters & Schema

| Parameter | Type | Required | Default | Description |
| :--- | :--- | :--- | :--- | :--- |
| `link` | String | **Yes** | `—` | 1688 Product URL (e.g. https://detail.1688.com/offer/780923930086.html) or Offer/SKU ID (e.g. 780923930086) |
| `day` | Integer | **No** | `90` | Historical timeframe in days (30, 60, 90, 180, 365) |
| `currency` | String | **No** | `CNY` | Currency code (CNY, USD, EUR, GBP, CAD, AUD, JPY) |

***

### How To Use (Step-by-Step)

1. **Open Actor on Apify Store:** Navigate to `1688 Price History & Daily Orders Tracker: China Sourcing API` on the Apify Store.
2. **Configure Input:** Provide your target `link` and select your execution mode in the Input tab.
3. **Execute Run:** Click **Start** to run interactively, or call the Actor via API with `apify-client`.
4. **Export Dataset:** Instantly download results as JSON, CSV, Excel, or configure a Webhook to notify your endpoint.

***

### Transparent Pay-Per-Event (PPE) Pricing

- **Free Users:** **$0.10** per run.
- **Paid Apify Members:** Fixed unit rate of **$0.005** per query execution ($5 per 1,000 queries).
- **Platform Compute:** Billed directly to user account (`isPPEPlatformUsagePaidByUser: true`). Developer is never billed for platform usage.

***

### Frequently Asked Questions (FAQ)

#### 1. What exact JSON fields and structured attributes are returned by 1688 Price History & Daily Orders Tracker API?

Every run returns schema-validated JSON into your Apify Dataset containing all primary operational metrics, normalized attributes (`link`, `day`, `currency`), and execution metadata matching the OpenAPI specification.

#### 2. How do I configure the input parameters (`link`, `day`, `currency`) for optimal results?

You can configure `link`, `day`, `currency` directly in the Apify Console or via JSON payload. Required parameters must be provided; optional parameters default to high-throughput production presets.

#### 3. Does 1688 Price History & Daily Orders Tracker API require API keys, cookies, or upstream accounts?

No. The service manages all upstream session pooling, proxy rotation, header forging, and token exchange automatically with zero account hurdles or login credentials required.

#### 4. What is the benchmark execution latency for 1688 Price History & Daily Orders Tracker API?

Queries average ~200ms – 400ms globally, served through optimized high-speed edge PoPs with persistent session pooling and zero proxy overhead.

#### 5. How does Pay-Per-Event (PPE) monetization work for 1688 Price History & Daily Orders Tracker API?

Free users pay $0.10 per run. Paid Apify subscribers pay $0.005 per query ($5 per 1,000 queries). Platform compute is billed directly to the user account with zero developer markup (`isPPEPlatformUsagePaidByUser: true`).

#### 6. How are error states (HTTP 400, 429, 500) formatted and handled?

If an invalid parameter or upstream issue occurs, the Actor returns a machine-readable JSON error and marks the run strictly as FAILED with `Actor.fail()`, ensuring downstream automation pipelines never ingest false positives.

#### 7. Can I schedule automated recurring executions for 1688 Price History & Daily Orders Tracker API?

Yes! Configure Apify Schedules to trigger automated runs daily, weekly, or hourly to ingest fresh data into your downstream systems.

#### 8. Can I pipe 1688 Price History & Daily Orders Tracker API outputs directly into LangChain, n8n, Make, or Zapier?

Yes! You can consume the REST API or Apify Client SDK in Python/Node.js, or use Apify's native webhooks to push live outputs into AI agent workflows and automation platforms.

#### 9. Can I export datasets from 1688 Price History & Daily Orders Tracker API to CSV, Excel, or Google Sheets?

Yes! Apify enables one-click exports to JSON, CSV, and Excel, as well as automatic live synchronization with Google Sheets.

#### 10. Does 1688 Price History & Daily Orders Tracker API support high-concurrency batch execution?

Yes. The architecture scales elastically across edge nodes, allowing dozens of concurrent requests to execute in parallel without throttling.

***

### Keywords & Search Tags

`1688`, `1688 price history`, `1688 daily orders`, `china sourcing`, `alibaba wholesale`, `dropshipping`, `price tracking`, `sales tracker`, `ecommerce intelligence`, `1688-price-history-orders`, `apify actor`, `cloud scraper`, `automation`

# Actor input Schema

## `link` (type: `string`):

1688 Product URL (e.g. https://detail.1688.com/offer/780923930086.html) or Offer/SKU ID (e.g. 780923930086)

## `day` (type: `integer`):

Historical timeframe in days (30, 60, 90, 180, 365)

## `currency` (type: `string`):

Currency code (CNY, USD, EUR, GBP, CAD, AUD, JPY)

## Actor input object example

```json
{
  "link": "https://detail.1688.com/offer/780923930086.html",
  "day": 90,
  "currency": "CNY"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `keyValueStoreResult` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "link": "https://detail.1688.com/offer/780923930086.html",
    "day": 90,
    "currency": "CNY"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/1688-price-history-orders").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "link": "https://detail.1688.com/offer/780923930086.html",
    "day": 90,
    "currency": "CNY",
}

# Run the Actor and wait for it to finish
run = client.actor("dev00/1688-price-history-orders").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "link": "https://detail.1688.com/offer/780923930086.html",
  "day": 90,
  "currency": "CNY"
}' |
apify call dev00/1688-price-history-orders --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dev00/1688-price-history-orders"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KRwPapoSwELR3EBQy/builds/5X8m7CyXyGoRKDlOa/openapi.json
