エージェンシーランキング - 売上ランキング

概要

TikTokパートナーエージェンシーの売上ランキングデータを取得します。以下の機能をサポートします。

• フィルターパラメータの設定が可能
• カスタムソート順に対応

エンドポイント

    POST /agency/v1/rank/salesRank

リクエストボディ

フィールド	型	必須	説明
filter	object	いいえ	フィルターパラメータ
orderby	object	いいえ	ソートパラメータ
page	integer	いいえ	ページ番号, デフォルト値: 1
pagesize	integer	いいえ	1ページあたりの件数, デフォルト: 10

filter オプション

フィールド	型	必須	説明
region	string	いいえ	地域
date_info	object	いいえ	日付情報

region 範囲: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

orderby オプション

フィールド	必須	説明
usd_gmv	いいえ	GMV（降順）

リクエスト例

curl 'https://openapi.fastmoss.com/agency/v1/rank/salesRank' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "date_info": {
            "type": "week",
            "value": "2026-05"
        }
    },
    "orderby": [
      {
        "field": "usd_gmv",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

レスポンスボディ

data.total

結果の総数

data.list

フィールド	型	説明
id	string	エージェンシーID
secid	string	エージェンシーsecid
region	integer	地域
currency	integer	通貨
gmv	integer	GMV
usd_gmv	integer	USD GMV
gmv_inc_rate	string	GMV成長率
commission_rate	integer	コミッション率
hot_category	array<object>	人気カテゴリ
total_affiliate_count	integer	総アフィリエイトクリエイター数
inc_affiliate_count	integer	新規アフィリエイトクリエイター数
sale_affiliate_count	integer	アクティブ販売クリエイター数
product_count	integer	総商品数
inc_product_count	integer	新規商品数
sale_product_count	integer	アクティブ販売商品数
agency	object	エージェンシー情報

data.list.agency

フィールド	型	説明
id	string	エージェンシーID
secid	string	エージェンシーsecid
name	string	エージェンシー名
region	string	エージェンシー地域
introduction	string	エージェンシー紹介
logo_cover	string	エージェンシーロゴ

レスポンス例

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": "8649512756612795142",
        "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
        "region": "GB",
        "currency": "GBP",
        "gmv": 209066.76,
        "usd_gmv": 259242.78,
        "gmv_inc_rate": "-24.91%",
        "commission_rate": 990,
        "hot_category": [
          { "category_id": 14, "name": "Beauty & Personal Care" },
          { "category_id": 2, "name": "Womenswear & Underwear" },
          { "category_id": 3, "name": "Menswear & Underwear" }
        ],
        "total_affiliate_count": 301,
        "inc_affiliate_count": 67,
        "sale_affiliate_count": 138,
        "product_count": 63610,
        "inc_product_count": 656,
        "sale_product_count": 22035,
        "agency": {
          "id": "8649512756612795142",
          "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
          "name": "VibraVerse",
          "region": "GB",
          "introduction": "",
          "logo_cover": "https://s.500fd.com/tt_partner/wsos65b11f86df324b05"
        }
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-03"
  },
  "msg": "success"
}