RCSBAdvSearch Search Structures

Overview

Advanced search of RCSB Protein Data Bank structures by combining multiple attribute filters. Filter by organism (species), resolution, experimental method (X-RAY DIFFRACTION, ELECTRON MICROSCOPY, SOLUTION NMR), polymer description, and deposition date. Also supports free-text search combined with attribute filters. Use this when you need to find PDB structures matching specific criteria (e.g., all human cryo-EM structures below 3 Angstrom resolution). Returns PDB IDs sorted by resolution or date.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

128ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "experimental_method": {
      "description": "Filter by experimental method. Must be EXACT value: 'X-RAY DIFFRACTION', 'ELECTRON MICROSCOPY', 'SOLUTION NMR', 'NEUTRON DIFFRACTION', 'ELECTRON CRYSTALLOGRAPHY'.",
      "type": [
        "string",
        "null"
      ]
    },
    "max_resolution": {
      "description": "Maximum resolution in Angstroms. Lower values mean higher resolution. Examples: 1.5 (very high), 2.0 (high), 3.0 (moderate), 4.0 (low). Only applies to X-ray and cryo-EM structures.",
      "type": [
        "number",
        "null"
      ]
    },
    "min_deposition_date": {
      "description": "Only structures deposited after this date. Format: YYYY-MM-DD. Example: '2023-01-01' for structures deposited in 2023 or later.",
      "type": [
        "string",
        "null"
      ]
    },
    "organism": {
      "description": "Filter by source organism (exact match). Examples: 'Homo sapiens', 'Mus musculus', 'Escherichia coli', 'Saccharomyces cerevisiae', 'SARS-CoV-2'.",
      "type": [
        "string",
        "null"
      ]
    },
    "polymer_description": {
      "description": "Filter by polymer entity description (contains words). Examples: 'kinase', 'hemoglobin', 'antibody', 'DNA polymerase'.",
      "type": [
        "string",
        "null"
      ]
    },
    "query": {
      "description": "Free-text search query. Examples: 'insulin receptor', 'CRISPR-Cas9', 'COVID spike protein'. Can be combined with other attribute filters.",
      "type": [
        "string",
        "null"
      ]
    },
    "rows": {
      "description": "Number of results to return (default: 10, max: 50).",
      "type": "integer"
    },
    "sort_by": {
      "description": "Sort results by: 'resolution' (best resolution first, default), 'date' (newest first), 'weight' (smallest first).",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

{
  "rows": 1
}

Identifiers

Catalog ID

tu_RCSBAdvSearch_search_structures

Tool name

RCSBAdvSearch_search_structures

Added

2026-04-30 22:47Z

Tags

tooluniverse