Digested Protein DB REST API Documentation

GET https://digestedproteindb.pbf.hr/search.php

Retrieves a list of peptide/protein records filtered by the specified mass range.
This endpoint supports pagination and returns results in JSON format.

Name	Type	Required	Description
mass1	float	Yes	Lower bound of the mass range (inclusive).
mass2	float	Yes	Upper bound of the mass range (inclusive).
page	integer	No	Page number for pagination. Default is 1.
pageSize	integer	No	Number of results per page. Default is 10. Maximum allowed is 100.

GET https://digestedproteindb.pbf.hr/search.php?mass1=1500.6&mass2=1500.8&page=1&pageSize=10

Content-Type: application/json

Response structure:

{
  "total": 234,
  "page": 1,
  "pageSize": 10,
  "results": [
    {
      "id": 1234,
      "name": "Peptide_ABC",
      "mass": 1500.67,
      "sequence": "AGTKQV...",
      "description": "Optional description"
      // ... other fields as returned by the API
    }
    // ... more results
  ]
}

Fields:

• total – Total number of matching records.
• page – Current page number.
• pageSize – Number of records per page.
• results – Array of record objects, each with:
  • id – Unique record identifier
  • name – Record or peptide name
  • mass – Observed mass
  • sequence – Amino acid sequence (if provided)
  • description – Description (optional)
  • ...other fields as present in the API response

• 400 Bad Request – Returned if required parameters are missing or invalid.
• 500 Internal Server Error – Returned if the server encounters an error.

curl "https://digestedproteindb.pbf.hr/search.php?mass1=1500.6&mass2=1500.8&page=1&pageSize=10"

• Both mass1 and mass2 parameters are required and should be valid float values.
• The endpoint is optimized for fast, read-only access and supports efficient querying by mass range.
• For best performance, keep pageSize within reasonable limits (e.g., 10–100).