@millenniumearl/f95api v2.0.0-beta.13.2

F95API

Unofficial Typescript API used for data scraping from the F95Zone platform.

These APIs have been developed to support this application and allow you to obtain data on games and mods on the platform F95zone (NSFW)

A simple usage example can be found in src/example.ts

Table of Contents

• Main features
• Login
• Data scraping
• Classes
  • Handiwork
    • Basic properties
    • Mixed properties
  • Platform user
  • User data
  • Login result
• Logging
• Guidelines for errors

Main features

• Support for two-factor authentication
• Structured and typed data of games, mods, comics, assets and animations
• Structured and typed data of the current user (threads followed, favorites...)
• Structured and typed data of other users (titles, donations, registration date...)
• Standard search, through the "Latest Updates" page or advanced
• Saving of cookies to maintain the session

Login

In addition to traditional login, two-factor authentication via callback that returns the OTP value is also supported.

// Normal login
let result = await F95API.login(username, password);

// 2FA login
let 2faCallback = function () => Promise<number>;
let result = await F95API.login(username, password, 2faCallback);

Refer to src/example.ts (lines 35-67) for a working example.

Data scraping

Each game, mod, comic, animation or asset is identified as handiwork and obtaining this element is generic, it will then be up to the user to decide which property to use based on the type of handiwork that has been requested.

Handiworks can be obtained by query or by URL.

// With query
const query = {
    category: "games";
    keywords = "Your game name";
    order = "likes";
};

let listOfFoundGames = await F95API.searchHandiwork<Game>(query);

// With URL
let specificGame = await F95API.getHandiworkFromURL<Game>("the URL of your game");

While user data (after authenticating) with

const userdata = new UserProfile();

// Fetch basic data (always necessary)
await userdata.fetch();

// Fetch all data (may take a while)
await userdata.fetch(true);

// Async properties
const threads = await userdata.watched;
const bookmarks = await userdata.bookmarks;
const alerts = await userdata.alerts;
const games = await userdata.featuredGames;

Classes

Handiwork

Information about games, mods, etc... are stored in a Handiwork object with the following fields:

Basic properties

This list of properties is common to every handiwork, be it a game, a comic, etc...

Mixed properties

Each property is specific to a particular type of handiwork.

The serialization/deserialization in JSON format of this object is possible through JSON.stringify()/JSON.parse().

Platform user

A generic user registered on the platform is represented by a PlatformUser object with the following fields:

User data

The user data currently connected through this API extends the PlatformUser class via the class UserProfile and adds:

Login results

The outcome of the authentication process is represented by the LoginResult object:

Logging

To log the behavior of the application log4js-api is used with a default level of "warn". This option can be changed with the loggerLevel property.

Guidelines for errors

• If you can, return a meaningful value
• Return null only if the function should return a complex object (including strings)
• Return an empty array if the function should return an array
• Return false, -1 when the function should return boolean or number
• Throw an exception only if it is an error or if a wrong value could mess up the functioning of the library
• For all network operations, return a Result object