pablouser1/tikscraper

Get data from TikTok API

v2.4.0.3 2023-10-06 22:15 UTC

Requires

• php: >=7.4|^8.0
• ext-curl: *
• ext-json: *
• ext-xml: *
• guzzlehttp/guzzle: ^7.8
• php-webdriver/webdriver: ^1.12
• sapistudio/seleniumstealth: ^1.0

Requires (Dev)

• pestphp/pest: ^1.22

MIT

• Pablo Ferreiro

README

A Wrapper for the TikTok API made with PHP

How to Use

$api = new \TikScraper\Api([
    'user_agent' => 'YOUR_CUSTOM_USER_AGENT_HERE',
    'cookie_path' => 'PATH_HERE', // Path to store TikTok's cookies, defaults to /tmp/tiktok.json
    'proxy' => 'http://user:password@hostname:port',
    // More info about signing below
    'signer' => [
        'method' => 'remote',
        'url' => 'http://localhost:8080/signature',
        'close_when_done' => true // ONLY FOR BROWSER SIGNING, set to true if you want to quit the browser after making the request (default true)
    ]
], $cacheEngine);

$hashtag = $api->hashtag('funny');
$hashtag->feed();

if ($hastag->ok()) {
    echo $hashtag->getFull()->toJson(true);
} else {
    print_r($hashtag->error());
}

Signing

For using TikScrapperPHP you need to use a signing service. There are multiple available:

Remote signing

This method involves using an external signer.

• Set 'method' to remote
• Set 'url' to the signing endpoint

Currently supported:

• tiktok-signature (uses headless Chrome browser)
• SignTok (uses JSDOM)

Browser

This method involves using a chromedriver instance.

• Set 'method' to browser
• Set 'url' to the chromedriver endpoint (usually http://localhost:4444)

You can also generate the documentation available using PHPDoc

Caching

TikScrapperPHP supports caching requests, to use it you need to implement CacheInterface.php

TODO

• Search
• Comments

Credits

• @Sharqo78: Working TikTok downloader without watermark

HUGE thanks to the following projects, this wouldn't be possible without their help

• TikTok-API-PHP
• TikTok-Api
• tiktok-signature
• tiktok-scraper