SocialFetch

List videos from a TikTok profile by handle.

Resource: api.socialfetch.dev/v1/tiktok/profiles/:handle/videos

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043

Payment methods: — · Last validation: 2026-09-13 22:56:18.464+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "pathParams": {
        "type": "object",
        "required": [
          "handle"
        ],
        "properties": {
          "handle": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "description": "TikTok handle whose videos should be listed."
          }
        }
      },
      "queryParams": {
        "type": "object",
        "properties": {
          "trim": {
            "type": "boolean",
            "description": "Optional flag for a smaller response with fewer fields."
          },
          "cursor": {
            "type": "string",
            "minLength": 1,
            "description": "Pagination cursor returned by a previous response."
          },
          "region": {
            "type": "string",
            "description": "Optional ISO 3166-1 country code for the request."
          },
          "sortBy": {
            "enum": [
              "latest",
              "popular"
            ],
            "type": "string",
            "description": "Optional sort order for the returned TikTok videos."
          },
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "Optional TikTok user id to speed up the request."
          },
          "hostMedia": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "enum": [
                  "0",
                  "1",
                  "true",
                  "false"
                ],
                "type": "string"
              }
            ],
            "description": "When true, hosts source media for 90 days and returns delivery URLs in each video's `hostedMedia`."
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object"
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
        "amount": "14000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "14000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.