Search asset
curl --request POST \
--url https://app.chainpatrol.io/api/v2/asset/search \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"content": "<string>",
"assetId": 123,
"assetIds": [
123
],
"includeEnrichments": false
}
'import requests
url = "https://app.chainpatrol.io/api/v2/asset/search"
payload = {
"content": "<string>",
"assetId": 123,
"assetIds": [123],
"includeEnrichments": False
}
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({content: '<string>', assetId: 123, assetIds: [123], includeEnrichments: false})
};
fetch('https://app.chainpatrol.io/api/v2/asset/search', 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/asset/search",
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([
'content' => '<string>',
'assetId' => 123,
'assetIds' => [
123
],
'includeEnrichments' => false
]),
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/asset/search"
payload := strings.NewReader("{\n \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\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/asset/search")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.chainpatrol.io/api/v2/asset/search")
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 \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\n}"
response = http.request(request)
puts response.read_body{
"asset": {
"id": 123,
"content": "<string>",
"type": "URL",
"status": "UNKNOWN",
"watchStatus": "ENABLED",
"livenessStatus": "UNKNOWN",
"blockedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
},
"reports": [
{
"id": 123,
"title": "<string>",
"status": "TODO",
"createdAt": "<string>",
"reportedByCustomer": true,
"proposals": [
{
"id": 123,
"status": "UNKNOWN",
"reviewStatus": "PENDING",
"createdAt": "<string>",
"reviews": [
{
"id": 123,
"decision": "APPROVE",
"escalationTarget": "CUSTOMER",
"label": "<string>",
"reviewer": {
"kind": "STAFF",
"name": "<string>",
"role": "SUPERUSER"
},
"createdAt": "<string>"
}
]
}
]
}
],
"scans": [
{
"id": 123,
"createdAt": "<string>",
"enrichments": [
{
"id": 123,
"type": "<string>",
"source": "<string>",
"status": "PENDING",
"createdAt": "<string>",
"files": [
{
"id": 123,
"type": "SCREENSHOT",
"url": "<string>",
"fileName": "<string>",
"mimeType": "<string>",
"sizeBytes": 123,
"createdAt": "<string>"
}
],
"output": "<unknown>"
}
]
}
],
"takedown": {
"id": 123,
"status": "TODO",
"createdAt": "<string>",
"updatedAt": "<string>",
"tasks": [
{
"id": 123,
"type": "HOSTING_PROVIDER",
"status": "TODO",
"retractionStatus": "NOT_RETRACTED",
"externalId": "<string>",
"submittedAt": "<string>",
"retractedAt": "<string>",
"lastResponseAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"takedownProvider": {
"name": "<string>"
}
}
]
},
"blockedBy": [
{
"consumer": "<string>",
"name": "<string>",
"consumedAt": "<string>"
}
],
"results": [
{
"asset": {
"id": 123,
"content": "<string>",
"type": "URL",
"status": "UNKNOWN",
"watchStatus": "ENABLED",
"livenessStatus": "UNKNOWN",
"blockedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
},
"reports": [
{
"id": 123,
"title": "<string>",
"status": "TODO",
"createdAt": "<string>",
"reportedByCustomer": true,
"proposals": [
{
"id": 123,
"status": "UNKNOWN",
"reviewStatus": "PENDING",
"createdAt": "<string>",
"reviews": [
{
"id": 123,
"decision": "APPROVE",
"escalationTarget": "CUSTOMER",
"label": "<string>",
"reviewer": {
"kind": "STAFF",
"name": "<string>",
"role": "SUPERUSER"
},
"createdAt": "<string>"
}
]
}
]
}
],
"scans": [
{
"id": 123,
"createdAt": "<string>",
"enrichments": [
{
"id": 123,
"type": "<string>",
"source": "<string>",
"status": "PENDING",
"createdAt": "<string>",
"files": [
{
"id": 123,
"type": "SCREENSHOT",
"url": "<string>",
"fileName": "<string>",
"mimeType": "<string>",
"sizeBytes": 123,
"createdAt": "<string>"
}
],
"output": "<unknown>"
}
]
}
],
"takedown": {
"id": 123,
"status": "TODO",
"createdAt": "<string>",
"updatedAt": "<string>",
"tasks": [
{
"id": 123,
"type": "HOSTING_PROVIDER",
"status": "TODO",
"retractionStatus": "NOT_RETRACTED",
"externalId": "<string>",
"submittedAt": "<string>",
"retractedAt": "<string>",
"lastResponseAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"takedownProvider": {
"name": "<string>"
}
}
]
},
"blockedBy": [
{
"consumer": "<string>",
"name": "<string>",
"consumedAt": "<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": []
}Assets
Buscar assets
Search for an asset by content or ID and get its status, associated reports, and takedown details
POST
/
asset
/
search
Search asset
curl --request POST \
--url https://app.chainpatrol.io/api/v2/asset/search \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"content": "<string>",
"assetId": 123,
"assetIds": [
123
],
"includeEnrichments": false
}
'import requests
url = "https://app.chainpatrol.io/api/v2/asset/search"
payload = {
"content": "<string>",
"assetId": 123,
"assetIds": [123],
"includeEnrichments": False
}
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({content: '<string>', assetId: 123, assetIds: [123], includeEnrichments: false})
};
fetch('https://app.chainpatrol.io/api/v2/asset/search', 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/asset/search",
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([
'content' => '<string>',
'assetId' => 123,
'assetIds' => [
123
],
'includeEnrichments' => false
]),
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/asset/search"
payload := strings.NewReader("{\n \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\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/asset/search")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.chainpatrol.io/api/v2/asset/search")
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 \"content\": \"<string>\",\n \"assetId\": 123,\n \"assetIds\": [\n 123\n ],\n \"includeEnrichments\": false\n}"
response = http.request(request)
puts response.read_body{
"asset": {
"id": 123,
"content": "<string>",
"type": "URL",
"status": "UNKNOWN",
"watchStatus": "ENABLED",
"livenessStatus": "UNKNOWN",
"blockedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
},
"reports": [
{
"id": 123,
"title": "<string>",
"status": "TODO",
"createdAt": "<string>",
"reportedByCustomer": true,
"proposals": [
{
"id": 123,
"status": "UNKNOWN",
"reviewStatus": "PENDING",
"createdAt": "<string>",
"reviews": [
{
"id": 123,
"decision": "APPROVE",
"escalationTarget": "CUSTOMER",
"label": "<string>",
"reviewer": {
"kind": "STAFF",
"name": "<string>",
"role": "SUPERUSER"
},
"createdAt": "<string>"
}
]
}
]
}
],
"scans": [
{
"id": 123,
"createdAt": "<string>",
"enrichments": [
{
"id": 123,
"type": "<string>",
"source": "<string>",
"status": "PENDING",
"createdAt": "<string>",
"files": [
{
"id": 123,
"type": "SCREENSHOT",
"url": "<string>",
"fileName": "<string>",
"mimeType": "<string>",
"sizeBytes": 123,
"createdAt": "<string>"
}
],
"output": "<unknown>"
}
]
}
],
"takedown": {
"id": 123,
"status": "TODO",
"createdAt": "<string>",
"updatedAt": "<string>",
"tasks": [
{
"id": 123,
"type": "HOSTING_PROVIDER",
"status": "TODO",
"retractionStatus": "NOT_RETRACTED",
"externalId": "<string>",
"submittedAt": "<string>",
"retractedAt": "<string>",
"lastResponseAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"takedownProvider": {
"name": "<string>"
}
}
]
},
"blockedBy": [
{
"consumer": "<string>",
"name": "<string>",
"consumedAt": "<string>"
}
],
"results": [
{
"asset": {
"id": 123,
"content": "<string>",
"type": "URL",
"status": "UNKNOWN",
"watchStatus": "ENABLED",
"livenessStatus": "UNKNOWN",
"blockedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
},
"reports": [
{
"id": 123,
"title": "<string>",
"status": "TODO",
"createdAt": "<string>",
"reportedByCustomer": true,
"proposals": [
{
"id": 123,
"status": "UNKNOWN",
"reviewStatus": "PENDING",
"createdAt": "<string>",
"reviews": [
{
"id": 123,
"decision": "APPROVE",
"escalationTarget": "CUSTOMER",
"label": "<string>",
"reviewer": {
"kind": "STAFF",
"name": "<string>",
"role": "SUPERUSER"
},
"createdAt": "<string>"
}
]
}
]
}
],
"scans": [
{
"id": 123,
"createdAt": "<string>",
"enrichments": [
{
"id": 123,
"type": "<string>",
"source": "<string>",
"status": "PENDING",
"createdAt": "<string>",
"files": [
{
"id": 123,
"type": "SCREENSHOT",
"url": "<string>",
"fileName": "<string>",
"mimeType": "<string>",
"sizeBytes": 123,
"createdAt": "<string>"
}
],
"output": "<unknown>"
}
]
}
],
"takedown": {
"id": 123,
"status": "TODO",
"createdAt": "<string>",
"updatedAt": "<string>",
"tasks": [
{
"id": 123,
"type": "HOSTING_PROVIDER",
"status": "TODO",
"retractionStatus": "NOT_RETRACTED",
"externalId": "<string>",
"submittedAt": "<string>",
"retractedAt": "<string>",
"lastResponseAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"takedownProvider": {
"name": "<string>"
}
}
]
},
"blockedBy": [
{
"consumer": "<string>",
"name": "<string>",
"consumedAt": "<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": []
}Descripción general
El endpoint Buscar assets devuelve un único resultado con cuatro partes principales:- asset - El Asset (activo digital: URL, dirección, perfil, app, etc.) coincidente: su
id,content,type,status,watchStatusy marcas de tiempo (createdAt,updatedAt). - reports - Lista de reportes vinculados al asset, cada uno con
id,title,statusycreatedAt. - takedown - Metadatos del Takedown (solicitud de baja de contenido fraudulento):
id,statusy marcas de tiempo, más un arreglo tasks. Cada tarea tienetype,status,retractionStatus, el nombre deltakedownProviderasociado, marcas de tiempo de envío y de retractación, y unexternalIdopcional con el ID de seguimiento del proveedor. Más información sobre las tareas de takedown. - blockedBy - Lista de plataformas que actualmente consumen (bloquean) el asset. Cada entrada tiene un slug
consumer(p. ej.metamask,google-safe-browsing,quad9), elnamevisible de la plataforma y una marca de tiempoconsumedAtque indica cuándo la plataforma empezó a bloquear el asset.
Inicio rápido
Autenticación
Incluye tu clave de API en el encabezadoX-API-KEY:
X-API-KEY: <api-key>
Autorizaciones
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.
Cuerpo
application/json
Asset search request body
When true, the asset's 10 most recent scans also carry their enrichments, including the browser_capture entry whose screenshotUrl and domUrl point at the captured page. Off by default, and bounded to 10 scans when on, because enrichment payloads are large. Older scans are still listed, just without the enrichments field.
Respuesta
Successful response
¿Esta página le ayudó?