🌎 Trendgetter

Trendgetter is a free and open-source API that provides trending data from various platforms such as Google, YouTube, X, Reddit, GitHub, and TikTok.

Installing

Using npm:

npm install @trendgetter/core

Using yarn:

yarn add @trendgetter/core

Usage

Import the package:

import * as trendgetter from '@trendgetter/core';

Fetch trending data using the desired platform:

const results = await trendgetter.youtube.videos();
console.log(results);

Available Platforms

trendgetter.github.repos();
trendgetter.google.topics();
trendgetter.reddit.posts();
trendgetter.tiktok.videos();
trendgetter.x.tags();
trendgetter.youtube.videos();

Note: Some platforms may require API keys:

trendgetter.youtube.apiKey = 'YOUTUBE_API_KEY';

If you are using environment variables, they will be picked up automatically.

Using Parameters

Each platform's methods accept an optional params object to customize the request:

const results = await trendgetter.youtube.videos({ regionCode: 'GB', maxResults: 5 });
console.log(results);

See the API Documentation for detailed information on available parameters for each platform.

Contributing

Feel free to open issues or submit pull requests for improvements or new features!