API Reference

curl "$BASE_URL/v1/search/google?q=jane+doe+leaks&num=50&hl=en&gl=us" \
  -H "Authorization: Bearer $API_KEY"

{
  "query": "jane doe leaks",
  "engine": "google",
  "section": "web",
  "total_results": 1840000,
  "results": [
    {
      "position": 1,
      "title": "Jane Doe Leaked Videos — Watch Free",
      "link": "https://superpirate.xyz/jane-doe",
      "domain": "superpirate.xyz",
      "snippet": "Watch Jane Doe leaked videos free in HD...",
      "piracy": {
        "is_pirate": true,
        "category": "video cloud",
        "tracked_leaks": 128411
      }
    },
    {
      "position": 2,
      "title": "Jane Doe (@janedoe) — Official",
      "link": "https://onlyfans.com/janedoe",
      "domain": "onlyfans.com",
      "snippet": "Official page of Jane Doe.",
      "piracy": { "is_pirate": false }
    }
  ]
}

curl "$BASE_URL/v1/search/bing?q=jane+doe+leaks&num=50" \
  -H "Authorization: Bearer $API_KEY"

curl "$BASE_URL/v1/search/yandex?q=jane+doe+leaks&num=50" \
  -H "Authorization: Bearer $API_KEY"

curl "$BASE_URL/v1/piracy/domains/fapello.com" \
  -H "Authorization: Bearer $API_KEY"

{
  "domain": "fapello.com",
  "is_pirate": true,
  "category": "image host",
  "threat": { "level": 4, "label": "Critical" },
  "tracked_leaks": 1284110,
  "reported_infringements": 96731,
  "capabilities": {
    "source_removal": true,
    "google_delisting": true
  },
  "description": "High-volume aggregator redistributing paywalled creator content..."
}

<!-- BranditScan Leak Check widget -->
<iframe src="https://branditscan.com/embed/leak-check" title="Free Leak Check by BranditScan" style="display:block;width:100%;max-width:960px;margin:0 auto;height:620px;border:0;border-radius:24px;background:url(https://branditscan.com/front/lp/assets/images/leak-widget-spinner.svg) no-repeat center 140px;" scrolling="no" loading="lazy"></iframe>
<script>
window.addEventListener("message", function (e) {
  if (e.origin !== "https://branditscan.com" || !e.data || e.data.type !== "bs-leak-check:height") return;
  document.querySelectorAll("iframe[src^='https://branditscan.com/embed/leak-check']").forEach(function (f) {
    if (f.contentWindow === e.source) f.style.height = Math.ceil(e.data.height) + "px";
  });
});
</script>

// OUT — sent by the widget on every layout change (auto-height):
//   { "type": "bs-leak-check:height", "height": 1240 }

// IN — prefill + run a scan from your own page:
var frame = document.querySelector("iframe[src*='/embed/leak-check']");
frame.contentWindow.postMessage(
  { type: "bs-leak-check:scan", stagename: "jane doe" },
  "https://branditscan.com"
);

<!-- BranditScan Self Submissions widget — embed URL issued per platform -->
<iframe src="https://branditscan.com/embed/self-submission?platform=YOUR_PLATFORM_KEY"
        title="Submit takedowns — BranditScan"
        style="display:block;width:100%;max-width:960px;margin:0 auto;height:720px;border:0;border-radius:24px;"
        scrolling="no" loading="lazy"></iframe>

{
  "url": "https://fapello.com/jane-doe/",
  "website": "fapello.com",
  "state": "Source Removed",   // Submitted → In Progress → Source Removed / Delisted
  "updated_at": "2026-07-18T09:12:44+00:00"
}

curl -X POST https://branditscan.com/api/platform/sso/token \
  -H "Authorization: Bearer bsp_12_XXXXXXXXXXXXXXXXXXXX" \
  -H "X-Platform-Timestamp: 1767225600" \
  -H "X-Platform-Signature: 3f2a9c1e8b..." \
  -H "Content-Type: application/json" \
  -d '{"reference": "tg_482913"}'

{
  "redirect_url": "https://branditscan.com/sso/platform/hnJdQ3...64-char-token...kQ",
  "expires_at": "2026-07-14T18:08:21+00:00",
  "expires_in": 300
}

curl -X POST https://branditscan.com/api/v2/manager/users/report \
  -H "Authorization: Bearer $MANAGER_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"membership": "premium", "from_date": "2026-06-01", "to_date": "2026-06-30"}'

const crypto = require("crypto");

const timestamp = Math.floor(Date.now() / 1000).toString();
const body = JSON.stringify(payload); // exact raw body you will send

const signature = crypto
  .createHmac("sha256", process.env.BS_SIGNING_SECRET)
  .update(timestamp + "." + body)
  .digest("hex");

// Headers:
//   Authorization:        Bearer bsp_12_XXXXXXXXXXXXXXXXXXXX
//   X-Platform-Timestamp: timestamp
//   X-Platform-Signature: signature

curl -X POST https://branditscan.com/api/platform/users \
  -H "Authorization: Bearer bsp_12_XXXXXXXXXXXXXXXXXXXX" \
  -H "X-Platform-Timestamp: 1767225600" \
  -H "X-Platform-Signature: 3f2a9c1e8b..." \
  -H "Content-Type: application/json" \
  -d '{"email": "creator@example.com", "stagenames": ["jane doe"], "external_id": "tg_482913"}'

{
  "user": {
    "bs_user_id": 38412,
    "external_id": "tg_482913",
    "email": "creator@example.com",
    "is_premium": false,
    "membership": 0
  }
}

curl -X POST https://branditscan.com/api/platform/scans \
  -H "Authorization: Bearer bsp_12_XXXXXXXXXXXXXXXXXXXX" \
  -H "X-Platform-Timestamp: 1767225600" \
  -H "X-Platform-Signature: 9d41be07ac..." \
  -H "Content-Type: application/json" \
  -d '{"reference": "tg_482913"}'

{
  "scan": {
    "id": 512,
    "reference": "tg_482913",
    "bs_user_id": 38412,
    "queue": "first-search",
    "progress": 100,
    "completed": true,
    "created_at": "2026-07-14T18:03:21+00:00",
    "completed_at": "2026-07-14T19:41:05+00:00",
    "summary": {
      "total_links": 1204,
      "total_views": 8125940,
      "total_loss": 24377,
      "total_domains": 87,
      "top_websites": [
        { "domain": "fapello.com", "links_count": 214 },
        { "domain": "leakedzone.com", "links_count": 168 }
      ]
    }
  }
}

{
  "data": [
    {
      "id": 981220431,
      "url": "https://fapello.com/jane-doe/",
      "title": "Jane Doe Nude Leaks",
      "website": "fapello.com",
      "views": 48210,
      "states": ["Active"],
      "in_dmca": true,
      "found_at": "2026-07-14T19:22:41+00:00"
    }
  ],
  "pagination": { "page": 1, "per_page": 25, "total": 1204, "last_page": 49 }
}