Takedowns List

List takedowns

curl --request POST \
  --url https://app.chainpatrol.io/api/v2/takedowns/list \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "organizationSlug": "<string>",
  "query": "<string>",
  "startDate": "<string>",
  "endDate": "<string>",
  "assetType": [],
  "takedownStatus": [],
  "livenessStatus": [],
  "brandIds": [
    1
  ],
  "assigneeIds": [
    1
  ],
  "startedAtStartDate": "<string>",
  "startedAtEndDate": "<string>",
  "hideAutomatedTakedowns": true,
  "hideAutomatedLivenessChecks": true,
  "sorting": [
    {}
  ],
  "per_page": 10,
  "next_page": "<string>"
}
'

import requests

url = "https://app.chainpatrol.io/api/v2/takedowns/list"

payload = {
    "organizationSlug": "<string>",
    "query": "<string>",
    "startDate": "<string>",
    "endDate": "<string>",
    "assetType": [],
    "takedownStatus": [],
    "livenessStatus": [],
    "brandIds": [1],
    "assigneeIds": [1],
    "startedAtStartDate": "<string>",
    "startedAtEndDate": "<string>",
    "hideAutomatedTakedowns": True,
    "hideAutomatedLivenessChecks": True,
    "sorting": [{}],
    "per_page": 10,
    "next_page": "<string>"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organizationSlug: '<string>',
    query: '<string>',
    startDate: '<string>',
    endDate: '<string>',
    assetType: [],
    takedownStatus: [],
    livenessStatus: [],
    brandIds: [1],
    assigneeIds: [1],
    startedAtStartDate: '<string>',
    startedAtEndDate: '<string>',
    hideAutomatedTakedowns: true,
    hideAutomatedLivenessChecks: true,
    sorting: [{}],
    per_page: 10,
    next_page: '<string>'
  })
};

fetch('https://app.chainpatrol.io/api/v2/takedowns/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.chainpatrol.io/api/v2/takedowns/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'organizationSlug' => '<string>',
    'query' => '<string>',
    'startDate' => '<string>',
    'endDate' => '<string>',
    'assetType' => [
        
    ],
    'takedownStatus' => [
        
    ],
    'livenessStatus' => [
        
    ],
    'brandIds' => [
        1
    ],
    'assigneeIds' => [
        1
    ],
    'startedAtStartDate' => '<string>',
    'startedAtEndDate' => '<string>',
    'hideAutomatedTakedowns' => true,
    'hideAutomatedLivenessChecks' => true,
    'sorting' => [
        [
                
        ]
    ],
    'per_page' => 10,
    'next_page' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.chainpatrol.io/api/v2/takedowns/list"

	payload := strings.NewReader("{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.chainpatrol.io/api/v2/takedowns/list")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.chainpatrol.io/api/v2/takedowns/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "takedowns": [
    {
      "id": 123,
      "externalId": "<string>",
      "hasFilingDelay": true,
      "hasLivenessCheckDelay": true,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "asset": {
        "id": 123,
        "content": "<string>",
        "blockedAt": "<string>"
      },
      "assignee": {
        "id": 123,
        "fullName": "<string>"
      },
      "brand": {
        "id": 123,
        "name": "<string>",
        "slug": "<string>"
      },
      "domainRegistrar": {
        "id": 123,
        "name": "<string>"
      },
      "hostingProvider": {
        "id": 123,
        "name": "<string>"
      },
      "tldRegistrar": {
        "id": 123,
        "name": "<string>"
      }
    }
  ],
  "next_page": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

POST

takedowns

list

List takedowns

curl --request POST \
  --url https://app.chainpatrol.io/api/v2/takedowns/list \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "organizationSlug": "<string>",
  "query": "<string>",
  "startDate": "<string>",
  "endDate": "<string>",
  "assetType": [],
  "takedownStatus": [],
  "livenessStatus": [],
  "brandIds": [
    1
  ],
  "assigneeIds": [
    1
  ],
  "startedAtStartDate": "<string>",
  "startedAtEndDate": "<string>",
  "hideAutomatedTakedowns": true,
  "hideAutomatedLivenessChecks": true,
  "sorting": [
    {}
  ],
  "per_page": 10,
  "next_page": "<string>"
}
'

import requests

url = "https://app.chainpatrol.io/api/v2/takedowns/list"

payload = {
    "organizationSlug": "<string>",
    "query": "<string>",
    "startDate": "<string>",
    "endDate": "<string>",
    "assetType": [],
    "takedownStatus": [],
    "livenessStatus": [],
    "brandIds": [1],
    "assigneeIds": [1],
    "startedAtStartDate": "<string>",
    "startedAtEndDate": "<string>",
    "hideAutomatedTakedowns": True,
    "hideAutomatedLivenessChecks": True,
    "sorting": [{}],
    "per_page": 10,
    "next_page": "<string>"
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    organizationSlug: '<string>',
    query: '<string>',
    startDate: '<string>',
    endDate: '<string>',
    assetType: [],
    takedownStatus: [],
    livenessStatus: [],
    brandIds: [1],
    assigneeIds: [1],
    startedAtStartDate: '<string>',
    startedAtEndDate: '<string>',
    hideAutomatedTakedowns: true,
    hideAutomatedLivenessChecks: true,
    sorting: [{}],
    per_page: 10,
    next_page: '<string>'
  })
};

fetch('https://app.chainpatrol.io/api/v2/takedowns/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.chainpatrol.io/api/v2/takedowns/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'organizationSlug' => '<string>',
    'query' => '<string>',
    'startDate' => '<string>',
    'endDate' => '<string>',
    'assetType' => [
        
    ],
    'takedownStatus' => [
        
    ],
    'livenessStatus' => [
        
    ],
    'brandIds' => [
        1
    ],
    'assigneeIds' => [
        1
    ],
    'startedAtStartDate' => '<string>',
    'startedAtEndDate' => '<string>',
    'hideAutomatedTakedowns' => true,
    'hideAutomatedLivenessChecks' => true,
    'sorting' => [
        [
                
        ]
    ],
    'per_page' => 10,
    'next_page' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.chainpatrol.io/api/v2/takedowns/list"

	payload := strings.NewReader("{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.chainpatrol.io/api/v2/takedowns/list")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.chainpatrol.io/api/v2/takedowns/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"organizationSlug\": \"<string>\",\n  \"query\": \"<string>\",\n  \"startDate\": \"<string>\",\n  \"endDate\": \"<string>\",\n  \"assetType\": [],\n  \"takedownStatus\": [],\n  \"livenessStatus\": [],\n  \"brandIds\": [\n    1\n  ],\n  \"assigneeIds\": [\n    1\n  ],\n  \"startedAtStartDate\": \"<string>\",\n  \"startedAtEndDate\": \"<string>\",\n  \"hideAutomatedTakedowns\": true,\n  \"hideAutomatedLivenessChecks\": true,\n  \"sorting\": [\n    {}\n  ],\n  \"per_page\": 10,\n  \"next_page\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "takedowns": [
    {
      "id": 123,
      "externalId": "<string>",
      "hasFilingDelay": true,
      "hasLivenessCheckDelay": true,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "asset": {
        "id": 123,
        "content": "<string>",
        "blockedAt": "<string>"
      },
      "assignee": {
        "id": 123,
        "fullName": "<string>"
      },
      "brand": {
        "id": 123,
        "name": "<string>",
        "slug": "<string>"
      },
      "domainRegistrar": {
        "id": 123,
        "name": "<string>"
      },
      "hostingProvider": {
        "id": 123,
        "name": "<string>"
      },
      "tldRegistrar": {
        "id": 123,
        "name": "<string>"
      }
    }
  ],
  "next_page": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

This API requires an API key with appropriate permissions. See API Key Documentation for more details.

This endpoint uses cursor-based pagination for efficient retrieval of large datasets. If you encounter errors related to payload size, please use the pagination feature as described below.

Pagination

To use pagination, include the per_page and next_page parameters in your request:

per_page <number>: Number of takedowns to return per page (min: 1, max: 100)
next_page <string>: Cursor for the next page of results

Example implementation for pagination:

async function fetchAllTakedowns() {
  let allTakedowns = [];
  let nextPage = null;
  while (true) {
    const response = await fetch(
      "https://app.chainpatrol.io/api/v2/takedowns/list",
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "X-API-KEY": "YOUR_API_KEY_HERE",
        },
        body: JSON.stringify({
          per_page: 100,
          next_page: nextPage,
          takedownStatus: ["TODO", "IN_PROGRESS"],
          livenessStatus: ["ALIVE"],
        }),
      }
    );
    const data = await response.json();
    allTakedowns = allTakedowns.concat(data.takedowns);
    nextPage = data.next_page;
    if (!nextPage) {
      break;
    }
  }
  return allTakedowns;
}
fetchAllTakedowns()
  .then((takedowns) => console.log("All takedowns:", takedowns))
  .catch((error) => console.error("Error fetching takedowns:", error));

async function fetchAllTakedowns(): Promise<any[]> {
  let allTakedowns: any[] = [];
  let nextPage: string | null = null;

  while (true) {
    const response = await fetch(
      "https://app.chainpatrol.io/api/v2/takedowns/list",
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "X-API-KEY": "YOUR_API_KEY_HERE",
        },
        body: JSON.stringify({
          per_page: 100,
          next_page: nextPage,
          takedownStatus: ["TODO", "IN_PROGRESS"],
          livenessStatus: ["ALIVE"],
        }),
      }
    );
    const data = await response.json();
    allTakedowns = allTakedowns.concat(data.takedowns);
    nextPage = data.next_page;

    if (!nextPage) {
      break;
    }
  }
  return allTakedowns;
}

fetchAllTakedowns()
  .then((takedowns) => console.log("All takedowns:", takedowns))
  .catch((error) => console.error("Error fetching takedowns:", error));

import requests

def fetch_all_takedowns() -> list:
    all_takedowns = []
    next_page = None
    while True:
        response = requests.post(
            "https://app.chainpatrol.io/api/v2/takedowns/list",
            headers={
                "Content-Type": "application/json",
                "X-API-KEY": "YOUR_API_KEY_HERE",
            },
            json={
                "per_page": 100,
                "next_page": next_page,
                "takedownStatus": ["TODO", "IN_PROGRESS"],
                "livenessStatus": ["ALIVE"],
            },
        )
        data = response.json()
        all_takedowns.extend(data["takedowns"])
        next_page = data.get("next_page")
        if not next_page:
            break
    return all_takedowns

try:
    takedowns = fetch_all_takedowns()
    print("All takedowns:", takedowns)
except Exception as error:
    print("Error fetching takedowns:", str(error))

Authorizations

X-API-KEY

string

header

required

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Body

application/json

List takedowns request body

Defaults to getting all takedowns in the last 30 days.

You can also choose a startDate and endDate for the range of takedown updates, most timestamp formats should work, we use Luxon for parsing the dates.

organizationSlug

string

Organization slug. Required when authenticating with a user session (Bearer token); ignored when using an API key (org is derived from the key).

query

string

Search query to filter takedowns by asset content

startDate

string

The start date to list takedowns from. This should be in the format YYYY-MM-DD and is inclusive.

endDate

string

The end date to list takedowns to. This should be in the format YYYY-MM-DD and is inclusive.

assetType

enum<string>[]

Filter by asset types

Available options:

URL,

PAGE,

ADDRESS,

DISCORD,

LINKEDIN,

TWITTER,

FACEBOOK,

YOUTUBE,

REDDIT,

TELEGRAM,

GOOGLE_APP_STORE,

APPLE_APP_STORE,

AMAZON_APP_STORE,

MICROSOFT_APP_STORE,

TIKTOK,

INSTAGRAM,

THREADS,

MEDIUM,

CHROME_WEB_STORE,

MOZILLA_ADDONS,

OPERA_ADDONS,

EMAIL,

PATREON,

OPENSEA,

FARCASTER,

IPFS,

GOOGLE_FORM,

WHATSAPP,

DISCORD_USER,

QUORA,

GITHUB,

TEACHABLE,

SUBSTACK,

DEBANK,

TAWK_TO,

JOTFORM,

PRIMAL,

BLUESKY,

SNAPCHAT,

DESO,

PINTEREST,

FLICKR,

GALXE,

VELOG,

NPM,

PYPI,

HEX,

DOCKER_HUB,

VOCAL_MEDIA,

TECKFINE,

TENDERLY,

HACKMD,

ETSY,

ZAZZLE,

BASENAME,

BILIBILI_TV,

VIMEO,

DAILYMOTION,

PHONE_NUMBER,

SLACK,

CALENDLY,

NGROK,

RARIBLE,

RUST_PACKAGE,

FLATHUB,

VIDLII,

VEVIOZ,

ISSUU,

SOUNDCLOUD,

ZAPPER,

REDNOTE,

SAMSUNG_APP_STORE,

HUAWEI_APP_STORE,

XIAOMI_APP_STORE,

TENCENT_APP_STORE,

OPPO_APP_STORE,

VIVO_APP_STORE,

F_DROID,

GOOGLE_AD,

BING_AD,

TWITCH,

BEHANCE,

ZORA,

META_AD,

SIGNAL,

DEVIANTART,

BANDCAMP,

ARCHIVE_ORG,

FIVE_HUNDRED_PX,

LUMA,

SMARTMONEYMATCH

takedownStatus

enum<string>[]

Filter by takedown status

Available options:

TODO,

IN_PROGRESS,

COMPLETED,

CANCELLED,

PENDING_RETRACTION,

RETRACTION_SENT,

RETRACTED,

PENDING_INPUT,

PENDING_EVIDENCE

livenessStatus

enum<string>[]

Filter by liveness status

Available options:

UNKNOWN,

ALIVE,

DEAD

brandIds

integer[]

Filter by brand IDs

Required range: x > 0

assigneeIds

integer[]

Filter by takedown assignee user IDs

Required range: x > 0

startedAtStartDate

string

Inclusive start of the takedown started at date range, in YYYY-MM-DD or ISO 8601. A takedown's started-at is the earliest IN_PROGRESS status-change event.

startedAtEndDate

string

Inclusive end of the takedown started at date range. Defaults to the current time when startedAtStartDate is provided alone.

hideAutomatedTakedowns

boolean

Hide takedowns whose target asset type (or content) is handled by the automated platform-takedown pipeline (e.g. Telegram, Medium, *.webflow.io).

hideAutomatedLivenessChecks

boolean

Hide takedowns whose asset type (or content) is checked for liveness automatically (e.g. Twitter, Bluesky, *.gitbook.io).

sorting

object[]

Sorting configuration

Show child attributes

per_page

integer

default:10

The number of takedowns to return per page

Required range: 1 <= x <= 100

next_page

string | null

Cursor for fetching the next page of results

Response

Successful response

Successful operation

takedowns

object[]

required

List of takedowns

Show child attributes

next_page

string | null

Cursor for fetching the next page of results

⌘I

External API

Assets

Blocklist Sync

Organization Assets

Organization Asset Groups

Organization Brands

Reports

Organization Reports

Threats

Disputes

Takedowns

Organization Metrics

Operations

Healthchecks

Account & Access

Webhooks

Authorizations

Body

Response

​Pagination

​Example implementation for pagination:

Authorizations

Body

Response

Pagination

Example implementation for pagination: