TiktokExplode.Extensions.DependencyInjection 1.2.2

TiktokExplode.Extensions.DependencyInjection

Microsoft.Extensions.DependencyInjection integration for TiktokExplode.

Provides AddTiktokExplode() — a fluent extension method on IServiceCollection that registers IVideoClient and optionally ISearchClient, and lets you choose independently between the Playwright or HTTP fetcher strategy for page fetching and search.

Installation

dotnet add package TiktokExplode.Extensions.DependencyInjection

Usage

// Default — Playwright fetcher for page fetching, all defaults
services.AddTiktokExplode();

// Playwright fetcher with a visible browser window (useful for debugging)
services.AddTiktokExplode(b => b
    .UsePlaywrightFetcher(o => o.Headless = false));

// HTTP fetcher for page fetching (faster, no browser dependency)
// with Playwright search support — recommended setup
services.AddTiktokExplode(b => b
    .UseHttpFetcher()
    .UsePlaywrightSearch(o => o.BrowserChannel = "msedge"));

// HTTP fetcher only — no search support
// Note: ISearchClient is NOT registered without UsePlaywrightSearch
services.AddTiktokExplode(b => b
    .UseHttpFetcher(o => o.WarmupDelay = TimeSpan.Zero)
    .ConfigureTiktok(o => o.MaxWafRetries = 5));

Then inject IVideoClient or ISearchClient normally:

public class MyService(IVideoClient client, ISearchClient search)
{
    public async Task<string> GetTitleAsync(string url)
    {
        var video = await client.GetVideoAsync(url);
        return video.Description;
    }

    public async IAsyncEnumerable<string> SearchTitlesAsync(string keyword)
    {
        await foreach (var video in search.SearchAsync(keyword))
            yield return video.Description;
    }
}

Registered services

Important: ISearchClient and ISearchFetcher are only registered when UsePlaywrightSearch is called. TikTok's search API requires a real browser to sign requests — it cannot be replicated with plain HTTP. If you omit UsePlaywrightSearch and attempt to inject ISearchClient, the DI container will throw a resolution error at runtime.

Cookie sharing: TiktokDownloadClient is registered as a singleton shared between IVideoClient and ISearchClient. Cookies obtained during a search session are automatically available when downloading, avoiding 403 Forbidden errors.

Builder API

Note: UsePlaywrightFetcher and UseHttpFetcher are mutually exclusive — the last one called wins. UsePlaywrightSearch is independent and can be combined with either.

Related packages

License

MIT — see LICENSE for details.