Skip to main content
GET
/
v1
/
scrape
/
tiktok-shop
/
search
Shop Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok-shop/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "query": "shoes",
    "total_products": 31,
    "products": {
      "0": {
        "product_id": "1729385227165405539",
        "title": "Test White Shoes",
        "image": {
          "height": 400,
          "width": 400,
          "uri": "tos-maliva-i-o3syd03w52-us/e14655759440eb5646d383d4b2e80c4b",
          "url_list": {
            "0": "https://p16-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/e14655759440eb5646d383d4b2e80c4b~tplv-fhlh96nyum-crop-webp:400:400.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001",
            "1": "https://p19-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/e14655759440eb5646d383d4b2e80c4b~tplv-fhlh96nyum-crop-webp:400:400.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001"
          }
        },
        "product_price_info": {
          "sku_id": null,
          "symbol_position": 1,
          "show_currency_space": false,
          "currency_show_mode": 1,
          "currency_name": "USD",
          "currency_symbol": "$",
          "sale_price_decimal": "1.00",
          "sale_price_format": "1.00",
          "single_product_price_format": "1.00",
          "single_product_price_decimal": "1.00",
          "sale_price_integer_part_format": "1",
          "sale_price_decimal_part_format": "00",
          "decimal_point_symbol": ".",
          "promotion_deduction_details": null
        },
        "rate_info": null,
        "sold_info": {
          "sold_count": 15
        },
        "seller_info": {
          "seller_id": "7494998206293379427",
          "shop_name": "Madshoes",
          "shop_logo": null
        },
        "seo_url": {
          "updated_at": "1770629776057",
          "canonical_url": "https://www.tiktok.com/shop/pdp/1729385227165405539",
          "slug": "test-white-shoes",
          "type": 2,
          "version": 2
        }
      }
    }
  },
  "credits_used": 1,
  "endpoint": "tiktok-shop/shop_search",
  "note": "This endpoint costs 1 credit per request"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt

Use this file to discover all available pages before exploring further.

💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

Term you want to search for

Example:

"shoes"

​
page
integer

Page number to retrieve

Example:

1

​
region
string

Region to search shop products in. Available options: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE

Example:

"US"

Response

Successful response

Key Response Fields:

  • query — The search term used
  • total_products — Total number of products returned
  • products[] — Array of matching products:
    • product_id — Unique product identifier
    • title — Product listing title
    • image — Product thumbnail with CDN URLs
    • product_price_info.currency_name — Price currency (e.g., USD)
    • product_price_info.currency_symbol — Currency symbol (e.g., $)
    • product_price_info.sale_price_decimal — Current sale price
    • product_price_info.sale_price_format — Formatted sale price string
    • rate_info — Product rating info (if available)
    • sold_info.sold_count — Total units sold
    • seller_info.seller_id — Seller/shop unique identifier
    • seller_info.shop_name — Shop display name
    • seller_info.shop_logo — Shop logo image (if available)
    • seo_url.canonical_url — Product page canonical URL
    • seo_url.slug — URL-friendly product slug