Tool detail

SocialFetch

Searches TikTok videos by free-text keyword and returns matching videos with optional date, region, and sort filters.

Categories: Social media

Use when

search TikTok for videos matching a keyword
find recent TikTok videos from a specific country
sort TikTok search results by likes or recency

Not for

not hashtag listing, use the hashtag.list endpoint instead
not a specific video's details or comments

Inputs

GET query params: query (string <=512 chars, required); cursor, datePosted, region, sortBy, trim all optional

Admitted input schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Opaque pagination cursor returned by a previous response."
    },
    "datePosted": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "yesterday",
        "this-week",
        "this-month",
        "last-3-months",
        "last-6-months",
        "all-time"
      ],
      "description": "Optional upload date filter for video results."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "Search query text for TikTok videos."
    },
    "region": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional two-letter ISO 3166-1 country code for localized search results."
    },
    "sortBy": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "relevance",
        "most-liked",
        "date-posted"
      ],
      "description": "Optional sort order for search results."
    },
    "trim": {
      "type": "boolean",
      "description": "When true, returns a smaller response with fewer fields."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://api.socialfetch.dev/v1/tiktok/search

Payment

Protocol: x402
Listed price: 0.014 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://api.socialfetch.dev/v1/tiktok/search
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z