# Tiktok Shop Scraper (`bhansalisoft/tiktok-shop-scraper`) Actor

Tiktok Shop Scraper advance tool for scrap any Tiktok shop product inoformation using shop url or product url.

- **URL**: https://apify.com/bhansalisoft/tiktok-shop-scraper.md
- **Developed by:** [bhansalisoft](https://apify.com/bhansalisoft) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### TikTok Shop Product Scraper

Extract complete **TikTok Shop product data** from product URLs, including price, availability, seller details, category information, product descriptions, images, reviews, and ecommerce metadata. This Apify actor is ideal for **market research, price monitoring, competitor analysis, inventory tracking, ecommerce intelligence, and product data collection**.

The scraper supports TikTok Shop product pages and returns structured JSON output that can be used with **Python, Node.js, Google Sheets, Excel, databases, or BI tools**.

### TikTok Shop scraper Features

- Extract Tiktok Shop based on URL
- Extract Tiktok Shop Category url wise
- Extract Tiktok Shop Keyword Wise

### Why use this TikTok Shop scraper?

This actor helps businesses, researchers, and developers collect TikTok Shop product information automatically without manual copying.

#### Extract valuable TikTok Shop data

- Product title and description
- Product availability (in stock / out of stock)
- Price information
- Discount and sale pricing
- Seller/store information
- Product category
- Category hierarchy
- Product images
- Reviews and ratings
- Product variations
- Shipping information
- Store URLs
- Product URLs
- Country-specific marketplace data
- Timestamps
- Structured JSON output

### Input

Provide one or multiple TikTok Shop product URLs.

Example input:

```text
Tiktok Shop URL
Tiktok Shop Category url
Tiktok Shop Keyword
```

You can run the actor with a list of product URLs for bulk scraping.

### Output

The actor returns a structured JSON array.

Example response:

```json
[
  {
    "url": "https://www.tiktok.com/view/product/1729762527861968902",
    "available": false,
    "availability": "out_of_stock",
    "In_stock": false,
    "category": "Shorts",
    "description": "Product images description: Women's Solid High Waist Skinny Shorts...",
    "store_details": {
      "name": null,
      "url": "https://shop.tiktok.com/us/store/elite-lane/8647402770962944006"
    },
    "seller_url": "https://shop.tiktok.com/us/store/elite-lane/8647402770962944006",
    "category_tree": [
      {
        "name": "Womenswear & Underwear",
        "url": "https://shop.tiktok.com/us/c/womenswear-underwear/601152"
      },
      {
        "name": "Women's Bottoms",
        "url": "https://shop.tiktok.com/us/c/women-s-bottoms/842376"
      },
      {
        "name": "Shorts",
        "url": "https://shop.tiktok.com/us/c/shorts/601266"
      }
    ],
    "target_countries": [
      "us"
    ],
    "store_country": "us",
    "timestamp": "2026-08-10T08:27:16.795Z"
  }
]
```

### Output fields

| Field            | Description                     |
| ---------------- | ------------------------------- |
| url              | TikTok product URL              |
| available        | Product availability status     |
| availability     | Human-readable availability     |
| In\_stock         | Boolean stock status            |
| description      | Product description             |
| currency         | Product currency                |
| initial\_price    | Original price                  |
| final\_price      | Sale price                      |
| discount\_percent | Discount percentage             |
| sold             | Number of units sold            |
| colors           | Available colors                |
| sizes            | Available sizes                 |
| shipping\_fee     | Shipping information            |
| specifications   | Product specifications          |
| reviews\_count    | Total review count              |
| reviews          | Product reviews                 |
| store\_details    | Seller/store information        |
| images           | Product images                  |
| videos           | Product videos                  |
| category         | Product category                |
| category\_url     | Category page URL               |
| category\_tree    | Full category hierarchy         |
| brand            | Brand name                      |
| seller\_url       | Seller page URL                 |
| return\_policy    | Return policy URL               |
| target\_countries | Supported marketplace countries |
| store\_country    | Marketplace country             |
| timestamp        | Scraping timestamp              |

### Common use cases

#### Ecommerce competitor monitoring

Track competitor products, pricing, availability, and category changes.

#### Price monitoring

Monitor price drops and promotions across TikTok Shop.

#### Inventory tracking

Detect when products become out of stock or available again.

#### Product research

Build datasets for trending TikTok products and marketplace analysis.

#### AI and data analysis

Feed structured ecommerce data into LLMs, analytics pipelines, dashboards, or recommendation systems.

### Bulk TikTok product scraping

The actor supports scraping multiple product URLs in a single run, making it suitable for large-scale product catalog collection.

Example:

```json
[
  {
    "url": "https://www.tiktok.com/view/product/1111111111111111111"
  },
  {
    "url": "https://www.tiktok.com/view/product/2222222222222222222"
  },
  {
    "url": "https://www.tiktok.com/view/product/3333333333333333333"
  }
]
```

### API integration

You can call this actor using the **Apify API** and receive JSON output programmatically.

Typical workflow:

1. Submit TikTok product URLs
2. Run the actor
3. Wait for completion
4. Download the dataset as JSON, CSV, Excel, or via API

### Perfect for

- Ecommerce businesses
- Marketplace researchers
- Amazon and Shopify sellers
- Pricing intelligence companies
- Data analysts
- AI developers
- Marketing agencies
- Dropshipping businesses
- Product monitoring tools

### Keywords

TikTok Shop Scraper, TikTok Product Scraper, TikTok Shop Product API, TikTok Ecommerce Scraper, TikTok Price Scraper, TikTok Seller Scraper, TikTok Product Dataset, TikTok Marketplace Data, TikTok Shop Automation, TikTok Product Monitoring, TikTok Shop Analytics, Ecommerce Data Scraper, Product Intelligence, Competitor Price Tracking, Inventory Monitoring, TikTok Shop JSON Export

This actor provides a fast and reliable way to collect **TikTok Shop product data at scale** with structured, analysis-ready output.

Thanks

# Actor input Schema

## `Tiktokshop_url` (type: `array`):

Paste Tiktok Shop URLS

## `Tiktokcategory_url` (type: `array`):

Paste Tiktok Category URLS

## `TiktokShop_Keyword` (type: `array`):

Paste Tiktok Shop Keyword

## `country` (type: `string`):

Tiktok Search country

## `maxResults` (type: `integer`):

Maximum number of results per URL or per search term overall (upper cap).

## Actor input object example

```json
{
  "Tiktokshop_url": [
    "https://www.tiktok.com/view/product/1729762527861968902",
    "https://shop-sg.tiktok.com/view/product/1730242941495248835"
  ],
  "Tiktokcategory_url": [
    "https://www.tiktok.com/shop/c/necklaces/605280"
  ],
  "TiktokShop_Keyword": [
    "T shirt"
  ],
  "country": "",
  "maxResults": 1000
}
```

# Actor output Schema

## `results` (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 = {
    "Tiktokshop_url": [
        "https://www.tiktok.com/view/product/1729762527861968902",
        "https://shop-sg.tiktok.com/view/product/1730242941495248835"
    ],
    "Tiktokcategory_url": [
        "https://www.tiktok.com/shop/c/necklaces/605280"
    ],
    "TiktokShop_Keyword": [
        "T shirt"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("bhansalisoft/tiktok-shop-scraper").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 = {
    "Tiktokshop_url": [
        "https://www.tiktok.com/view/product/1729762527861968902",
        "https://shop-sg.tiktok.com/view/product/1730242941495248835",
    ],
    "Tiktokcategory_url": ["https://www.tiktok.com/shop/c/necklaces/605280"],
    "TiktokShop_Keyword": ["T shirt"],
}

# Run the Actor and wait for it to finish
run = client.actor("bhansalisoft/tiktok-shop-scraper").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 '{
  "Tiktokshop_url": [
    "https://www.tiktok.com/view/product/1729762527861968902",
    "https://shop-sg.tiktok.com/view/product/1730242941495248835"
  ],
  "Tiktokcategory_url": [
    "https://www.tiktok.com/shop/c/necklaces/605280"
  ],
  "TiktokShop_Keyword": [
    "T shirt"
  ]
}' |
apify call bhansalisoft/tiktok-shop-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bhansalisoft/tiktok-shop-scraper"
        }
    }
}

```

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/mpb9fXlQLaBJQnN15/builds/O8qWyHVltDRVt3Zx7/openapi.json