Skip to main content

Get Unique Blocks for Samples

GET /uniqueblocks/samples/{comma_separated_sample_ids}
Returns unique basic blocks found across the specified samples.
comma_separated_sample_ids
string
required
Comma-separated list of sample IDs (e.g., “1,2,3”)
status
string
Response status
data
object
Unique blocks data including:
  • Block hashes and characteristics
  • Sample distribution
  • Frequency information
{
  "status": "successful",
  "data": {
    "unique_blocks": [
      {
        "picblockhash": "abcdef0123456789",
        "sample_ids": [1, 2],
        "frequency": 2
      }
    ],
    "summary": {
      "num_unique_blocks": 150,
      "num_samples": 3
    }
  }
}

Get Unique Blocks for Family

GET /uniqueblocks/family/{family_id}
Returns unique basic blocks found across all samples in a family.
family_id
integer
required
ID of the family
status
string
Response status
data
object
Unique blocks data for the entire family
This endpoint analyzes all samples belonging to the specified family and returns blocks that are unique to this family compared to the rest of the database.
{
  "status": "successful",
  "data": {
    "unique_blocks": [
      {
        "picblockhash": "abcdef0123456789",
        "sample_ids": [1, 2, 5, 8],
        "frequency": 4
      }
    ],
    "summary": {
      "num_unique_blocks": 420,
      "num_samples": 12,
      "family_id": 1
    }
  }
}

Build docs developers (and LLMs) love