Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/robertgrubb/tiktok-php

TikTok scraper in PHP
https://github.com/robertgrubb/tiktok-php

api php signing tiktok tiktok-api tiktok-scraper user users videos

Last synced: about 7 hours ago
JSON representation

TikTok scraper in PHP

Awesome Lists containing this project

README 

        
# TikTok Scraper in PHP



```

By default, this scraper will attempt to use NodeJS to sign the URL. If you do not have node installed, it will attempt to install it during the composer install step. If you do, it will simply find the path to it. If you'd like to change this logic, you can read more below about setting your signMethod => 'datafetch', an API I have created for signing tiktok urls.

```



# 1.9.14



Updates to the `user->account` method have been made. No changes in the response object.



# 1.9.13



Introducing `$scraper->user->videoFromEmbed('id');`



This will return video data from the embed endpoint. Right now it's more stable than the normal video route. The only catch is that it does not return



# 1.9.12



Setting verifyFp manually is now an option, as captcha verification has been taking TikTok by storm. You can set it like so:



```

$scraper = new Scraper([

  'verifyFp' => 'verify_xxxxx_xxxx_xxxx_xxx...'

])

```



If you do not set one, by default, the scraper will attempt to generate the following cookies for you:



```

verifyFp, tt_webid, and tt_webid_v2

```



However, in most cases at this moment, the fp token will end up being a trigger for captcha.



# Cookie File



In `v1.8.0`, the scraper now sets cookies by default, which means that you must provide writable permissions for a `cookies.json` file, and then set it in the configuration (see example config below).



Need to disable cookies? Set `'disableCookies' => true` in the configuration.



## Installation



```

composer require robert-grubb/tiktok-php

```



## Instantiation



```

require './vendor/autoload.php';



use TikTok\Scraper;



// Instantiate TikTok Scraper library

$scraper = new Scraper([

  // Sign method

  'signMethod' => 'datafetch'

  'datafetchApiKey' => ''

  'userAgent' => '',

  'proxy' => [

    'protocol' => 'http',

    'address' => '127.0.0.1:8080',

    'auth' => 'username:password'

  ],

  'timeout' => 20,



  // Since v1.8.0 (Must set cookie file)

  'cookieFile' => __DIR__ . '/cookies.json'



  // If not using cookies:

  'disableCookies' => true

]);

```



## Configuration Explained



```

[

  // Sign method

  'signMethod' => 'node' // Or datafetch



  // User agent

  'userAgent' => '',



  // Optional proxy (auth is also optional)

  'proxy' => [

    'protocol' => 'http',

    'address' => '127.0.0.1:8080',

    'auth' => 'username:password'

  ],



  // Time before curl request times out

  'timeout' => 20

]

```



## Search for a user



```

// 30 being the number of results

$scraper->user->search('username', 30);

```



## User data



```

$scraper->user->details('username');

```



## User videos



```

$scraper->user->videos(123415125125);



// Or use username, 10 is the count of videos to return.

$scraper->user->videos('iratee', 10);

```



## All User Videos



```

$scraper->user->allVideos(123415125125);



// Or use username

$scraper->user->allVideos('iratee');

```



## Specific User Video



```

$scraper->user->video('username', 123415125125);

```



## Download User Video



```

/**

 * 1st Param: username

 * 2nd Param: video_id

 * 3rd Param: watermark (default true)

 * 4th Param: path to download

 */

$scraper->user->downloadVideo('username', 123415125125, true, './');

```



## Discover



```

$scraper->discover->get('music');

$scraper->discover->get('user');

$scraper->discover->get('hashtag');



// Offset and count:



$scraper->general->discover('music', [

  'count' => 10,

  'offset' => 10

]);



```



## Trending



```

// 25 being the number of items to return.

$scraper->trending->videos(25);

```



## Music Data



```

// Gets data for music by id

$scraper->music->data(12312512512);

```



## Music Videos



```

// Gets videos for music (25 being the count)

$scraper->music->videos(12124124124, 25)

```



## Download Music by ID



```

/**

 * 1st Param: music_id

 * 2nd Param: path (optional)

 * 3rd Param: custom name (optional)

 */

$scraper->music->download(6821468236035541766, './', 'custom-name');

```



## Hashtag Data



```

$scraper->hashtag->data('beatbox');

```



## Hashtag Videos



```

// 30 being the count of videos to return

$scraper->hashtag->videos('beatbox', 30);

```



## Signing a URL



2 methods of signing the URL is provided.



1. You can use nodejs, this package will look to see if you have it installed, however, if you do not, it will attempt to install it.



2. You can use the datafet.ch api that I have personally built to accept requests from anyone to sign a tiktok url. (This package handles it automatically if you set `'signMethod' => 'datafetch'` in the configuration.)



```

$scraper->signUrl('TIKTOK_URL_HERE');

```



## DataFetch API Key



DataFetch API does rate limit your requests at a max of 100 requests per 15 minutes. This can be avoided by obtaining an API key, which will then give you access to unlimited requests. You can obtain access by contacting me at `matt [at] grubb [dot] com`.



# Errors



If anything error happens throughout the scraper, it will set the error at the following:



```

$scraper->error

```



Which will return the following structure:



```

[

  'error' => true,

  'message' => 'Detailed error message here.'

]

```



Also, the method you called will also return `false`.



---------------



If there was no error, two things you will notice:



1. `$scraper->error` is set to `false`

2. The method you called will not return `false`



# Legal



This repo and it's contents are in no way affiliated with, authorized, maintained, sponsored or endorsed by TikTok or any of its affiliates or subsidiaries. This is an independent and unofficial package. Use at your own risk.