×

API Documentation

Dear Domain-Hopping Site Owners and Developers, You can submit URLs directly using our API. No authorization is required for now. Since only the apex domain and/or subdomain is stored and the content path is stripped, we believe there is no reason for anyone to spam. This is also another reason the API is kept open.

Know more on Discord

Endpoint

POST https://thepiratetracker.com/submit.php

Fields

url (string, required) - Domain or full URL
category (string, required) - Videos, Music, Books, Games, Software, Others
submitter_name (string, optional) - defaults to "Anonymous"
api (int, optional) - 1 for JSON response

Behavior

- Submissions for the same domain within the last 30 days are blocked for both web and API.
- JSON response for API submissions includes status and message.
- OG title, description, and thumbnail are fetched automatically.
- Cron-safe: developers can submit automatically daily, but duplicate is blocked until 30 days expire.
- Invalid domains are rejected.

Example cURL (Bash)

• Put this in your cronjob to run every 30 Days.
• Or you can run this whenever you update your apache / nginx config files.

curl -X POST https://thepiratetracker.com/submit.php \
  -d "url=yoursupersitenamehere.com" \
  -d "category=Software" \
  -d "submitter_name=MyBot" \
  -d "api=1"

Response

{"status":"ok"}
or
{"status":"error","message":"Invalid URL"}
or
{"status":"error","message":"This site is already listed within the last 30 days."}

Example PHP Cron

<?php
$urls = ["yoursupersitename.com","anothersitename.com"];
$apiEndpoint = "https://thepiratetracker.com/submit.php";
$category = "Software";
$submitter = "MyBot";
foreach ($urls as $url) {
    $data = ['url'=>$url,'category'=>$category,'submitter_name'=>$submitter,'api'=>1];
    $ch = curl_init($apiEndpoint);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    echo "Submitted $url: $response\n";
}
?>