README

PHP SDK for OverseasSocial API -- post to 14+ social platforms, manage uploads, teams, analytics, and more.

English | 简体中文

Requirements

• PHP >= 7.4
• ext-fileinfo, ext-json

Installation

composer require jxx0410/bundlesocial-php

Quick Start

use Jxx0410\BundleSocial\OverseasSocial\Application;

$app = new Application([
    'api_key'  => 'YOUR_API_KEY',
    'base_uri' => 'YOUR_BASE_URI',
]);

// Upload → Post workflow
$upload = $app->upload->create('/path/to/image.jpg', 'team_xxx');

$post = $app->post->create([
    'teamId' => 'team_xxx',
    'title'  => 'Hello World',
    'status' => 'SCHEDULED',
    'postDate' => '2026-06-01T12:00:00Z',
    'socialAccountTypes' => ['INSTAGRAM', 'YOUTUBE'],
    'data' => [
        'INSTAGRAM' => [
            'text' => 'Hello from SDK!',
            'type' => 'POST',
            'uploadIds' => [$upload['id']],
        ],
    ],
]);

Services

Supported Platforms

Instagram, YouTube, TikTok, Facebook, Twitter/X, LinkedIn, Reddit, Pinterest, Mastodon, Bluesky, Discord, Slack, Google Business, Threads

Documentation

• Quick Start Guide -- Get running in minutes
• API Reference -- Complete method reference
• Hyperf Integration -- Use with Hyperf framework

Error Handling

The SDK throws typed exceptions for HTTP errors:

Testing

composer test
composer test-unit
composer test-coverage

License

MIT