ACRCloud
Visit WebsiteConsole
  • Introduction
  • Get Started
  • Console Tutorials
    • Recognize Music
    • Recognize Custom Content
    • Broadcast Monitoring for Music
    • Broadcast Monitoring for Custom Content
    • Detect Live & Timeshift TV Channels
    • Recognize Custom Content Offline
    • Recognize Live Channels and Custom Content
    • Find Potential Detections in Unknown Content Filter
  • SDK REFERENCE
    • Mobile SDK
      • iOS
      • Android
      • Unity
    • Backend SDK
      • Python
      • PHP
      • Go
      • Java
      • C/C++
      • C#
    • Error Codes
  • API Reference
    • Identification API
    • Console API
      • Access Token
      • Buckets
        • Audio Files
        • Live Channels
        • Dedup Files
      • Base Projects
      • OfflineDBs
      • BM Projects
        • Custom Streams Projects
          • Streams
          • Streams Results
          • Streams State
          • Recordings
          • Analytics
          • User Reports
        • Broadcast Database Projects
          • Channels
          • Channels Results
          • Channels State
          • Recordings
          • Analytics
          • User Reports
      • File Scanning
        • FsFiles
      • UCF Projects
        • BM Streams
        • UCF Results
    • Metadata API
  • Tools
    • Audio File Fingerprinting Tool
    • Local Monitoring Tool
    • Live Channel Fingerprinting Tool
    • File Scan Tool
  • Metadata
    • Music
    • Music (Broadcast Monitoring with Broadcast Database)
    • Custom Files
    • Live Channels
    • Humming
  • FAQ
    • Definition of Terms
  • Service Usage
Powered by GitBook
On this page
  • Deduplicate the track file
  • List all the duplicated files
  • Get one file's duplicated files
  • Delete an item
  1. API Reference
  2. Console API
  3. Buckets

Dedup Files

Deduplicate the track file

POST https://api-v2.acrcloud.com/api/buckets/:bucket_id/dedup-files

Upload the fingerprints to the "DedupFile" bucket, you will get the dup files, if there are no dup files, this fingerprint will be inserted into the fingerprint database.

Path Parameters

Name
Type
Description

bucket_id

string

The bucket id

Headers

Name
Type
Description

Authorization

string

Bearer Token

Request Body

Name
Type
Description

db_if_nodup

number

0 or 1. Whether insert the fingerprint into the database if there are no duplicated tracks in the database. The default value is 1

id

string

The unique track id

file

object

The fingerprint file

{"data":{"dup_files": ["123"], "acr_id":"7b475aff9cf72859f65effe81e741f0e", "do_db": false}}
curl --location --request POST 'https://us-api-v2.acrcloud.com/api/buckets/6556/dedup-files' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer Token' \
--form 'id="123"' \
--form 'file=@"/123.wma.db.lo"'
import requests

url = "https://us-api-v2.acrcloud.com/api/buckets/6556/dedup-files"

payload={'id': '123'}
files=[
  ('file',('123.wma.db.lo',open('/Users/Downloads/22494.wma.db.lo','rb'),'application/octet-stream'))
]
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer Token'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

List all the duplicated files

GET https://api-v2.acrcloud.com/api/buckets/:bucket_id/dedup-files

Path Parameters

Name
Type
Description

bucket_id

string

The bucket id

Query Parameters

Name
Type
Description

per_page

number

The results number per page

page

number

The page number

Headers

Name
Type
Description

Authorization

string

Bearer Token

{
    "data": [
        {
            "dup_files": [
                "8a8bfb8a",
                "1a8cfd55"
            ],
            "acr_id": "7b475aff9cf72859f65effe81e741f0e",
            "created_at": "2021-02-18 09:11:23",
            "updated_at": "2021-02-16 23:27:17"
        }
    ],
    "links": {
        "first": "https://us-api-v2.acrcloud.com/api/buckets/123/dedup-files?page=1",
        "last": "https://us-api-v2.acrcloud.com/api/buckets/123/dedup-files?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://us-api-v2.acrcloud.com/api/buckets/123/dedup-files",
        "per_page": "20",
        "to": 1,
        "total": 1
    }
}
curl --location --request GET 'https://us-api-v2.acrcloud.com/api/buckets/your_bucket_id/dedup-files' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer Token'
import requests

url = "https://us-api-v2.acrcloud.com/api/buckets/your_bucket_id/dedup-files"

headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer Token'
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Get one file's duplicated files

GET https://api-v2.acrcloud.com/api/buckets/:bucket_id/dedup-files/:file_id

Path Parameters

Name
Type
Description

file_id

string

The file id

bucket_id

string

The bucket id

Headers

Name
Type
Description

Authorization

string

Bearer token

{
    "data": [
        {
            "dup_files": [
                "8a8bfb8a",
                "1a8cfd55"
            ],
            "acr_id": "7b475aff9cf72859f65effe81e741f0e",
            "created_at": "2021-02-18 09:11:23",
            "updated_at": "2021-02-16 23:27:17"
        }
    ]
}
curl --location --request GET 'https://us-api-v2.acrcloud.com/api/buckets/123/dedup-files/8a8bfb8a' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token'
import requests

url = "https://us-api-v2.acrcloud.com/api/buckets/123/dedup-files/8a8bfb8a"

payload={}
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer token'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Delete an item

DELETE https://api-v2.acrcloud.com/api/buckets/:bucket_id/dedup-files/:acr_ids

Path Parameters

Name
Type
Description

bucket_id

number

The bucket id

acr_ids

string

One or more acrid

Headers

Name
Type
Description

Authorization

string

Bearer token

Last updated 1 year ago