> ## 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. # Product Reviews > Get a product's reviews (100 reviews per page). **Credit Cost:** 1 credit per request πŸ’³ **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/tiktok-shop/product-reviews openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/tiktok-shop/product-reviews: get: tags: - tiktok-shop summary: Product Reviews description: |- Get a product's reviews (100 reviews per page). **Credit Cost:** 1 credit per request operationId: tiktok-shop_Product_Reviews parameters: - name: url in: query description: The URL of the product (required if product_id is not provided) required: false schema: type: string example: >- https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516 - name: product_id in: query description: The ID of the product (required if url is not provided) required: false schema: type: string example: '1731578642912612516' - name: page in: query description: The page number of the reviews required: false schema: type: integer example: 1 responses: '200': description: |- Successful response **Key Response Fields:** - `has_more` β€” Whether additional review pages are available - `total_reviews` β€” Total number of reviews for the product - `product_reviews[]` β€” Array of individual reviews: - `review_id` β€” Unique review identifier - `product_id` β€” Associated product identifier - `sku_id` β€” SKU variant that was reviewed - `reviewer_id` β€” Reviewer's user identifier - `review_rating` β€” Star rating (1-5) - `review_time` β€” Review timestamp (milliseconds) - `is_verified_purchase` β€” Whether the reviewer purchased on TikTok Shop - `is_incentivized_review` β€” Whether the review was incentivized - `product_name` β€” Full product name at time of review - `reviewer_name` β€” Display name of the reviewer - `reviewer_avatar_url` β€” Reviewer's profile image URL - `review_text` β€” Full review text content - `display_image_url` β€” Primary review image thumbnail - `review_images[]` β€” Array of all review image URLs - `sku_specification` β€” SKU variant name reviewed (e.g., "Default") - `review_country` β€” Country code of the reviewer - `review_ratings` β€” Aggregated rating summary: - `review_count` β€” Total review count - `overall_score` β€” Average star rating - `rating_result` β€” Breakdown by star level (1-5) with counts content: application/json: example: success: true data: success: true has_more: true total_reviews: '125' product_reviews: '0': review_id: '7604501259405199118' product_id: '1731578642912612516' sku_id: '1731578664610402468' reviewer_id: '6671422695488847878' review_rating: 1 review_time: '1770560950661' is_verified_purchase: true is_incentivized_review: false product_name: >- Potaroma Cat Nail Clipper with 4-Size Adjustable Trimming Hole & Hidden Nail File | Safe Toenail Trimmer for Kittens & Indoor Cats | Anti-Splash Claw Cutter for Pet Grooming (Blue) reviewer_name: L**i πŸ“š**️ reviewer_avatar_url: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/9afb897d2643b2f5be8294efcf53e6bc~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=9b7cb0a2&x-expires=1771056000&x-signature=9Tk5uj8LspQx0fNCC8qfMn7421c%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5 review_text: >- Very unhappy with this it was you cannot get their little claws in there. It’s a teeny hole. It’s very cheap feeling display_image_url: >- https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/4efe29181984479099d096e8397a0ef7~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839 review_images: '0': >- https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/4efe29181984479099d096e8397a0ef7~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839 sku_specification: Default review_country: US '1': review_id: '7596893396606682894' product_id: '1731578642912612516' sku_id: '1731578664610402468' review_rating: 5 review_time: '1768789593613' is_verified_purchase: true is_incentivized_review: false product_name: >- Potaroma Cat Nail Clipper with 4-Size Adjustable Trimming Hole & Hidden Nail File | Safe Toenail Trimmer for Kittens & Indoor Cats | Anti-Splash Claw Cutter for Pet Grooming (Blue) reviewer_name: A**z review_text: >- Works well, i like the file on the bottom to even out my kitty’s claws. display_image_url: >- https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/18639bac735c44dd9e2e6ec5d586fd65~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839 review_images: '0': >- https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/18639bac735c44dd9e2e6ec5d586fd65~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839 sku_specification: Default review_country: US review_ratings: review_count: '125' overall_score: 4.4 rating_result: '1': '10' '2': '2' '3': '6' '4': '14' '5': '93' credits_used: 1 endpoint: tiktok-shop/product_reviews '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: Either product URL or product_id is required endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````