Tutorial

How to Scrape TikTok with Java

Step-by-step guide to scraping TikTok search results using Java and the Scavio API. Get video results, creator profiles, hashtag trends as structured JSON.

TikTok contains valuable data — video results, creator profiles, hashtag trends, TikTok Shop listings, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.

This tutorial shows you how to scrape TikTok using Java and the Scavio API. By the end, you will have a working Java script that fetches real-time TikTok data and parses the results.

Prerequisites

  • Java installed on your machine
  • A Scavio API key (free tier includes 500 credits/month — no credit card required)

Step 1: Install Dependencies

HttpClient is built into Java, so there is nothing to install.

Bash
# HttpClient is built into Java 11+

Step 2: Make Your First TikTok Search

Send a POST request to the Scavio TikTok API endpoint with your query. The API returns structured JSON with video results, creator profiles, hashtag trends, and more.

import java.net.http.*;
import java.net.URI;

var apiKey = "your_scavio_api_key";
var body = "{\"query\":\"" + query + "\"}";

var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.scavio.dev/api/v1/search"))
    .header("x-api-key", apiKey)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

var client = HttpClient.newHttpClient();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Step 3: Example Response

The API returns structured JSON. Here is an example response for a TikTok search:

JSON
{
  "search_metadata": { "status": "success" },
  "organic_results": [
    {
      "position": 1,
      "title": "This viral kitchen gadget is everywhere on TikTok",
      "link": "https://www.tiktok.com/@creator/video/12345",
      "snippet": "5.2M views · The #1 TikTok Shop product of the week..."
    }
  ]
}

Every field is structured and typed — no HTML parsing, no CSS selectors, no regex extraction. Your Java code can access any field directly.

Step 4: Full Working Example

Here is a complete, runnable Java script that searches TikTok and prints the results:

import java.net.http.*;
import java.net.URI;

/**
 * Scrape TikTok search results using Scavio API.
 * Requires Java 11+.
 */
public class TikTokSearch {

    private static final String API_URL = "https://api.scavio.dev/api/v1/search";
    private static final String API_KEY = System.getenv("SCAVIO_API_KEY");

    public static String search(String query) throws Exception {
        var body = "{\"query\":\"" + query + "\"}";

        var request = HttpRequest.newBuilder()
            .uri(URI.create(API_URL))
            .header("x-api-key", API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        var response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() != 200) {
            throw new RuntimeException("Scavio API error: " + response.statusCode());
        }

        return response.body();
    }

    public static void main(String[] args) throws Exception {
        System.out.println(search("site:tiktok.com viral product 2026"));
    }
}

Why Use Scavio Instead of Scraping TikTok Directly?

  • No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
  • No CAPTCHA solving. TikTok aggressively blocks automated requests. Scavio returns clean data every time.
  • Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
  • Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
  • Free tier included. 500 credits/month with no credit card required. Each search costs 1 credit.

Frequently Asked Questions

Scraping publicly available data from TikTok is generally legal, but you should review TikTok's Terms of Service. Using the Scavio API avoids the legal gray areas of direct scraping since Scavio handles all data collection through proper channels and returns structured results via API.

Direct scraping of TikTok requires managing proxies, CAPTCHAs, rate limits, and anti-bot detection. The Scavio API handles all of this for you. Send a POST request with your query and get structured JSON back — no proxy management or browser automation needed.

The Scavio API returns structured JSON with video results, creator profiles, hashtag trends, TikTok Shop listings, engagement signals, thumbnails. All data is returned in a clean, consistent format that is easy to parse in Java.

Scavio offers a free tier with 500 credits per month. Each API request costs 1 credit regardless of which platform you search. No credit card required to start. Paid plans start at $30/month for higher volumes.

Scavio returns TikTok results in 1-3 seconds on average. Results are fetched in real time from TikTok — there is no caching layer or stale data. Every request returns live results.

Start Scraping TikTok with Java

Get your free Scavio API key and start fetching TikTok data in Java. 500 free credits/month — no credit card required.