Query Goods Inventory For MCF

POST

/fbt/202601/mcf/goods/inventory/search

Search available inventory for MCF goods. Use this API to retrieve available quantities for the specified Fulfilled by TikTok goods IDs.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body^required

Media typeapplication/json

object

goods

required

Goods to query. The array must contain 1 to 50 entries.

Array<object>

object

goods_id

required

The Fulfilled by TikTok goods ID. The value must represent a positive integer.

string

Example

{
  "goods": [
    {
      "goods_id": "69167899745030"
    }
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

goods_inventory_list

Inventory entries for the requested goods. For MCF, only goods associated with the seller for the shop region and having an inventory-group result are returned. A requested goods ID without an inventory-group result is omitted; the API does not add an entry with available_qty set to 0. The list is empty when none of the requested goods has an inventory-group result. Each entry represents one goods-and-inventory-group result, so the same goods_id may appear in multiple entries when it has multiple inventory groups. Request goods IDs are not deduplicated; repeating a goods_id may repeat the same inventory-group entries. Include each goods_id only once, and do not align response entries with request entries by list position.

Array<object>

object

goods_id

The identifiers for goods generated by Fulfilled by TikTok system.

string

available_qty

Available inventory of goods

integer format: int64

Example

{
  "code": 0,
  "data": {
    "goods_inventory_list": [
      {
        "goods_id": "69167899745030",
        "available_qty": 10
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}