Search products in TikTok Shop by keyword

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "14000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "query": "shoes"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "data": {
            "page": {
              "currentPage": 1,
              "hasMore": false,
              "nextPage": null
            },
            "products": [
              {
                "description": null,
                "id": "1729505304355116874",
                "image": {
                  "height": null,
                  "url": null,
                  "width": null
                },
                "imageUrl": "https://p16.example.com/p.webp",
                "labels": [],
                "metrics": {
                  "rating": null,
                  "reviews": null,
                  "sold": null
                },
                "price": {
                  "currencyCode": null,
                  "currencySymbol": null,
                  "current": null,
                  "discountText": null,
                  "original": null,
                  "savingText": null
                },
                "shipFrom": null,
                "shop": {
                  "id": null,
                  "logoUrl": null,
                  "name": null
                },
                "title": "Sample product with missing rating data",
                "trustLabel": null,
                "url": "https://www.tiktok.com/shop/pdp/1729505304355116874"
              }
            ],
            "query": "tshirt",
            "totalProducts": 2
          },
          "meta": {
            "creditsCharged": 1,
            "requestId": "req_01example_sparse",
            "version": "v1"
          }
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "page": {
                  "description": "1-based results page number. Omit to request the first page. Pagination is page-based.",
                  "maximum": 9007199254740991,
                  "minimum": 1,
                  "type": "integer"
                },
                "query": {
                  "description": "Search query text for TikTok Shop products.",
                  "maxLength": 512,
                  "minLength": 1,
                  "type": "string"
                },
                "region": {
                  "description": "Optional country or region code for the product search catalog.",
                  "enum": [
                    "US",
                    "GB",
                    "DE",
                    "FR",
                    "IT",
                    "ID",
                    "MY",
                    "MX",
                    "PH",
                    "SG",
                    "ES",
                    "TH",
                    "VN",
                    "BR",
                    "JP",
                    "IE"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "query"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "payment-identifier": {
    "info": {
      "required": false
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "id": {
          "maxLength": 128,
          "minLength": 16,
          "pattern": "^[a-zA-Z0-9_-]+$",
          "type": "string"
        },
        "required": {
          "type": "boolean"
        }
      },
      "required": [
        "required"
      ],
      "type": "object"
    }
  }
}

curl "https://api.socialfetch.dev/v1/tiktok/shop/products/search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://api.socialfetch.dev/v1/tiktok/shop/products/search");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://api.socialfetch.dev/v1/tiktok/shop/products/search")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header