TikTok Post Search API for Openclaw

A high-performance AI agent skill for programmatic TikTok post discovery and trend analysis via keyword-based searching.

justoneapi
v1.0.0
Apr 30, 2026
0
658
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install justoneapi-tiktok-search-post

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install justoneapi-tiktok-search-post using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is TikTok Post Search API?

The TikTok Post Search API skill allows AI coding agents to interface directly with JustOneAPI to extract real-time data from the TikTok platform. It provides a robust gateway for developers using Openclaw Skills to search for posts using specific keywords, enabling the retrieval of critical metadata such as video IDs, captions, and author information.

This tool is designed to bridge the gap between AI agents and social media data, offering filtered search capabilities that include region-specific results and chronological sorting. It is an essential asset for building automated workflows that require deep insight into social media trends and audience sentiment.

TikTok Post Search API Use Cases

  • Tracking brand mentions and viral trends for specific keywords.
  • Performing competitive analysis by monitoring niche-specific content creators.
  • Gathering sentiment data for market research and consumer behavior studies.
  • Discovering high-engagement content for influencer marketing and content curation.

How TikTok Post Search API Works

  1. The AI agent initiates the search using the searchPostV1 operation ID.
  2. The user provides a mandatory search keyword (e.g., 'artificial intelligence').
  3. Optional filters such as region, publishTime, and sortType are applied to narrow the search scope.
  4. The skill executes a GET request to the JustOneAPI /api/tiktok/search-post/v1 endpoint using the provided token.
  5. The system returns structured JSON data containing post details for the agent to process or display.

TikTok Post Search API Setup

To integrate this skill into your environment, ensure you have Node.js installed and follow these steps:

  1. Obtain an API token from the Just One API Dashboard.
  2. Set your environment variable: export JUST_ONE_API_TOKEN='your_token_here'.
  3. Execute the skill using the following CLI pattern:
node ./bin/run.mjs --operation "searchPostV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"keyword":"deepseek", "region":"US"}'

TikTok Post Search API Data Schema & Taxonomy

Field Description
keyword The primary search term used to find relevant posts.
video_id Unique identifier for the TikTok video content.
description The text content/caption associated with the post.
author_info Metadata related to the post creator.
publishTime Filterable timeframes: ONE_DAY, ONE_WEEK, ONE_MONTH, THREE_MONTHS, HALF_YEAR, or ALL.
region ISO 3166-1 alpha-2 country code for localized results.

TikTok Post Search API Advanced Features

  • Pagination support via the offset parameter for large-scale data harvesting.
  • Advanced sorting logic to toggle between relevance-based and popularity-based (Most Liked) results.
  • Granular time-based filtering to isolate content from specific windows (e.g., last 24 hours).
  • Multi-region search capabilities for global trend monitoring within Openclaw Skills.
  • Low-latency data retrieval optimized for AI agent response cycles.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0

Featured*