README

A lightweight and modern PHP library for interacting with FurAffinity through HTML parsing.
Provides functionality for reading submissions, checking user activity, toggling favorites/watches, and working with the message center.

⚠️ This project is unofficial and not affiliated with FurAffinity.net. Use at your own discretion.

📦 Installation

You can install the library via Composer:

composer require d1kdat/furaffinity-api-php

This will automatically pull the latest version from Packagist and configure autoloading.

✅ Requirements

• PHP 8.1 or higher
• PHP extensions:
  • curl
  • iconv
  • pcre

🚀 Quick Usage

use FurAffinity\Exchange;

$settings = [
    'username' => 'your_username',
    'a' => 'cookie_a',
    'b' => 'cookie_b',
];

$fa = new Exchange($settings);

$submission = $fa->getById(22872063);

if ($submission !== false) {
    print_r($submission);
}

📚 Features

• 🔍 Get submission data by ID
• ⭐ Toggle favorites
• 👤 Toggle watch/unwatch
• ✅ Check login state
• 👁️ Check if a user exists
• 📥 Read your watchlist
• 📫 Read and remove new message center submissions

📂 Examples

See examples/ for ready-to-run scripts:

• get_submission_data.php
• get_watchlist.php
• check_user_exists.php
• check_log_in.php
• toggle_watch.php
• toggle_favorite.php
• remove_msg_submissions.php
• get_new_msg_submissions.php

Each example uses config.php or falls back to config.example.php for authentication.