> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Shop Store API

The TikTok Shop Store API returns a TikTok Shop (US) store - rating, followers, sold count, product, review and video counts - and its products in the store's sort orders, with token pagination.

> [!NOTE]
>
> HasData is an independent service and is not affiliated with, endorsed by, or sponsored by TikTok Shop. TikTok Shop is a trademark of its respective owner. This API works with publicly available data only.

## Get Your API Key

Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.

## Request Cost and API Credits

Each request to the TikTok Shop Store API consumes **API Credits** from your account balance.

* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.

> [!TIP]
>
> You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.

> [!WARNING]
>
> **Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.

To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).

## Make Your First Request

```bash cURL theme={null}
curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/tiktok-shop/store' \
  --data-urlencode 'sellerId=7494222678839887470' \
  --data-urlencode 'url=https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'
```

```javascript Node.js theme={null}
const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/tiktok-shop/store',
  params: {
    sellerId: '7494222678839887470',
    url: 'https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470'
  },
  headers: {'Content-Type': 'application/json', 'x-api-key': '<your-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```python Python theme={null}
import requests

url = "https://api.hasdata.com/scrape/tiktok-shop/store"

querystring = {"sellerId":"7494222678839887470","url":"https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470"}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```php PHP theme={null}
<?php

$params = [
    "sellerId" => "7494222678839887470",
    "url" => "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/tiktok-shop/store?" . http_build_query($params),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <your-api-key>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
```

```java Java theme={null}
OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/tiktok-shop/store")
  .newBuilder()
  .addQueryParameter("sellerId", "7494222678839887470")
  .addQueryParameter("url", "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470")
  .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("x-api-key", "<your-api-key>")
  .build();

Response response = client.newCall(request).execute();
```

```csharp C# theme={null}
using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["sellerId"] = "7494222678839887470";
query["url"] = "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470";

var url = $"https://api.hasdata.com/scrape/tiktok-shop/store?{query}";

var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "<your-api-key>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```

```ruby Ruby theme={null}
require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/tiktok-shop/store")
params = {
  "sellerId" => "7494222678839887470",
  "url" => "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470",
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = '<your-api-key>'

response = http.request(request)
puts response.read_body
```

```rust Rust theme={null}
use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client
        .get("https://api.hasdata.com/scrape/tiktok-shop/store")
        .query(&[("sellerId", "7494222678839887470")])
        .query(&[("url", "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	params := url.Values{}
	params.Set("sellerId", "7494222678839887470")
	params.Set("url", "https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470")

	u := "https://api.hasdata.com/scrape/tiktok-shop/store?" + params.Encode()

	req, _ := http.NewRequest("GET", u, nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "<your-api-key>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
```

## API Parameters

| Parameter | Default Value | Required | Description |
| - | - | - | - |
| `sellerId` | 7494222678839887470 | No | TikTok Shop seller id, the number at the end of a store URL. |
| `url` | [https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470](https://shop.tiktok.com/us/store/nami-matcha/7494222678839887470) | No | TikTok Shop store URL. |
| `sort` | - | No | Product order in the store. |
| `nextPageToken` | - | No | Pagination token returned by the previous response. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.