README

Scrape basic details from a public TikTok video URL in PHP. This is a cleaned-up, PSR‑4, PHP 8 rewrite using Guzzle and zero private APIs.

Features

• Minimal public video details: canonical URL, IDs, username, nickname, description, thumbnail and counters
• PSR‑4 autoloaded library with typed DTO output
• Pluggable Guzzle client for testing and timeouts
• No headless browser, no TikTok private API usage

Installation

Install via Composer:

composer require haianibrahim/tiktok-scraper

Quick Start

use GuzzleHttp\Client; // Or any ClientInterface
use Hki98\TikTok\TikTokScraper;

require __DIR__ . '/vendor/autoload.php';

$client = new Client();
$scraper = new TikTokScraper($client);

$details = $scraper->scrape('https://www.tiktok.com/@scout2015/video/6718335390845095173');

print_r($details->toArray());

Output shape:

• status: "ok"
• link
• user (nickname)
• username
• user_id
• video_id
• video_desc
• thumbnail
• views, likes, comments, shares, favorites

API

• TikTokScraper::scrape(string $url): VideoDetails
• VideoDetails::toArray(): array

Exceptions

• Base: Hki98\TikTok\Exception\TikTokScraperException (catch-all)
• Specific:
  • Hki98\TikTok\Exception\InvalidUrlException
  • Hki98\TikTok\Exception\HttpRequestException
  • Hki98\TikTok\Exception\EmptyResponseException
  • Hki98\TikTok\Exception\ParseException

Notes

• TikTok frequently changes HTML structure; this scraper parses the rehydration JSON in a script tag. If the key paths change, update the normalization method.
• Respect robots.txt and terms of service in your jurisdiction.

Development

• PHP 8.1+
• PSR‑12 coding style recommended
• Autoload: PSR‑4 under namespace Hki98\\TikTok (src/)

Run autoload dump after cloning:

composer dump-autoload

Credit

• Original author: Haian K. Ibrahim (https://github.com/haianibrahim)
• HTML parsing here is regex-based for one script tag; the bundled simple_html_dom.php is kept for historical context but not used by the new class.

License

GPL-3.0