Sample applicant vetting

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "items": [
    {
      "applicationId": "5800000000000000003",
      "found": true,
      "creatorId": "uACafQAAAABexampleOpenId0000000",
      "creatorUsername": "creator_one",
      "application": {
        "firstSeenAt": "2026-03-01T10:00:00.000Z",
        "currentState": "sample_requested",
        "products": [
          {
            "productId": "1729000000000000001",
            "productTitle": "Example Serum 30ml",
            "currentState": "sample_requested",
            "nativeStatus": "PENDING",
            "stateTimestamps": {
              "sample_requested": "2026-03-01T10:00:00.000Z"
            }
          }
        ]
      },
      "facts": {
        "followerCount": 48200,
        "pps": "4.5",
        "fulfillmentRate": 96.5,
        "medianVideoViews": 1800,
        "gmv30dAmount": "4520.10",
        "gmv30dCurrency": "USD",
        "contentCount": 140,
        "unitsSold": 320,
        "categories": [
          "Beauty & Personal Care"
        ],
        "enrichedAt": "2026-02-28T12:00:00.000Z"
      },
      "history": {
        "requests": 3,
        "byState": {
          "sample_requested": 0,
          "awaiting_shipment": 0,
          "sample_shipped": 0,
          "content_pending": 0,
          "content_warning": 0,
          "content_fulfilled": 2,
          "content_unfulfilled": 1,
          "cancelled": 0
        },
        "shipped": 3,
        "contentFulfilled": 2,
        "postedRate": 0.6667,
        "videosPosted": 3,
        "gmv": {
          "amount": "310.00",
          "currency": "USD",
          "orders": 16
        },
        "firstRequestSeenAt": "2026-01-02T10:00:00.000Z",
        "lastRequestSeenAt": "2026-02-10T10:00:00.000Z"
      }
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Sample applicant vetting

Returns facts for vetting sample applicants, for up to 50 application ids. Each item has the current application (products and state), the creator’s marketplace facts (followers, pps, fulfillment rate, median video views, 30-day GMV, categories) and their history in this shop across their other sample applications: requests by state, shipped, content fulfilled, postedRate, videos posted and GMV.

There’s no score or recommendation, so apply your own rules. History is keyed by the creator’s open id, not the handle, so a reused handle doesn’t pull in another creator’s samples. Pass applicationIds as a comma-separated list (1 to 50 after duplicates collapse). Items come back in your order. found: false means Growi has no sample row for that id. facts are platform-wide and a point in time. Served from Growi’s synced data.

GET

tik_tok_shop

samples

vetting

Sample applicant vetting

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/samples/vetting")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "items": [
    {
      "applicationId": "5800000000000000003",
      "found": true,
      "creatorId": "uACafQAAAABexampleOpenId0000000",
      "creatorUsername": "creator_one",
      "application": {
        "firstSeenAt": "2026-03-01T10:00:00.000Z",
        "currentState": "sample_requested",
        "products": [
          {
            "productId": "1729000000000000001",
            "productTitle": "Example Serum 30ml",
            "currentState": "sample_requested",
            "nativeStatus": "PENDING",
            "stateTimestamps": {
              "sample_requested": "2026-03-01T10:00:00.000Z"
            }
          }
        ]
      },
      "facts": {
        "followerCount": 48200,
        "pps": "4.5",
        "fulfillmentRate": 96.5,
        "medianVideoViews": 1800,
        "gmv30dAmount": "4520.10",
        "gmv30dCurrency": "USD",
        "contentCount": 140,
        "unitsSold": 320,
        "categories": [
          "Beauty & Personal Care"
        ],
        "enrichedAt": "2026-02-28T12:00:00.000Z"
      },
      "history": {
        "requests": 3,
        "byState": {
          "sample_requested": 0,
          "awaiting_shipment": 0,
          "sample_shipped": 0,
          "content_pending": 0,
          "content_warning": 0,
          "content_fulfilled": 2,
          "content_unfulfilled": 1,
          "cancelled": 0
        },
        "shipped": 3,
        "contentFulfilled": 2,
        "postedRate": 0.6667,
        "videosPosted": 3,
        "gmv": {
          "amount": "310.00",
          "currency": "USD",
          "orders": 16
        },
        "firstRequestSeenAt": "2026-01-02T10:00:00.000Z",
        "lastRequestSeenAt": "2026-02-10T10:00:00.000Z"
      }
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

applicationIds

string[]

required

Comma-separated numeric application ids, 1-50 after duplicates collapse.

Required array length: 1 - 50 elements

Pattern: ^[0-9]{1,32}$

organization_id

integer

Use the TikTok Shop of this child brand (organization id) of your API key's organization

Response

One item per requested application id

items

object[]

Show child attributes

Overview

Conversions

Tracking events

Campaign affiliates

Organization

Applications

Stats

TikTok Shop

Sample applicant vetting

Authorizations

Query Parameters

Response