README

PHP client library for working with structured entertainment and financial data from DropThe, a data utility media platform covering 25,000+ movies, series, cryptocurrencies, companies, and public figures. Built for PHP 8.0+ with strict typing, named arguments, and modern language features throughout.

Installation

composer require arnaudleroy-studio/dropthe

Quick Start

Browse entity categories

use DropThe\Client;

$client = new Client();

// List all verticals the platform covers
$verticals = $client->getVerticals();
// ['movies', 'series', 'cryptocurrencies', 'companies', 'people']

// Check coverage stats per vertical
$stats = $client->getStats(vertical: 'movies');
echo "{$stats['vertical']} — {$stats['count']} entities tracked";

Search and filter entities

// Type-safe search with named arguments
$results = $client->search(
    query: 'Nolan',
    vertical: 'people',
    limit: 5,
);

// Array destructuring from results
foreach ($results as ['name' => $name, 'slug' => $slug, 'type' => $type]) {
    echo "{$name} ({$type}) — dropthe.org/{$slug}\n";
}

Null-safe access for optional fields

$entity = $client->findBySlug('bitcoin');

// Entities may or may not have pricing data attached
$price = $entity?->getData('price_usd');
$tier = $entity?->getData('tier') ?? 'unranked';

echo "BTC: \${$price} — tier {$tier}";

Build filtered collections

// Arrow function for inline transforms
$slugs = array_map(
    fn(array $e) => $e['slug'],
    $client->search(vertical: 'movies', limit: 20)
);

// Retrieve multiple entities at once
$batch = $client->findMany(slugs: $slugs);

Available Data

The library provides structured access to DropThe's knowledge graph, which spans several content verticals. Movie and series records include metadata like release dates, cast links, and streaming availability across platforms. Cryptocurrency entries track real-time pricing alongside project fundamentals. Company profiles cover founding details, leadership, and industry classification. People records link individuals to the films, companies, and projects they are associated with, forming a navigable entity graph with nearly three million relationship edges.

Links

• DropThe Platform
• GitHub Repository

License

MIT License. See LICENSE for details.