RCSB PDB

RCSB PDB General API

The General API from RCSB PDB — 12 operation(s) for general.

GitHub OpenAPI

Operations 21

GET /v1/{id}/assembly Computes structural assembly #
POST /v1/{id}/assembly Computes structural assembly #
GET /v1/{id}/atoms Atoms satisfying the given criteria #
POST /v1/{id}/atoms Atoms satisfying the given criteria #
GET /v1/{id}/full The full structure #
POST /v1/{id}/full The full structure #
GET /v1/{id}/ligand Coordinates of the first group satisfying the given criteria #
POST /v1/{id}/ligand Coordinates of the first group satisfying the given criteria #
GET /v1/{id}/residueInteraction Identifies all residues within the given radius from the source residue. #
POST /v1/{id}/residueInteraction Identifies all residues within the given radius from the source residue. #
GET /v1/{id}/residueSurroundings Identifies all residues within the given radius from the source residue #
POST /v1/{id}/residueSurroundings Identifies all residues within the given radius from the source residue #
GET /v1/{id}/surroundingLigands Identifies (complete) ligands within the given radius from the source atom set. #
POST /v1/{id}/surroundingLigands Identifies (complete) ligands within the given radius from the source atom set. #
GET /v1/{id}/symmetryMates Computes crystal symmetry mates within the specified radius #
POST /v1/{id}/symmetryMates Computes crystal symmetry mates within the specified radius #
GET /v1/query-many Executes multiple queries at the same time and writes them as separate data… #
POST /v1/query-many Executes multiple queries at the same time and writes them as separate data… #
GET /{source}/{id}/ Returns a JSON response specifying if data is available and the maximum region… #
GET /{source}/{id}/box/{a1,a2,a3}/{b1,b2,b3}/ Returns density data inside the specified box for the given entry. #
GET /{source}/{id}/cell/ Returns (downsampled) volume data for the entire "data cell". #

Documentation

📖
Documentation
https://search.rcsb.org/redoc/index.html
📖
GettingStarted
https://www.rcsb.org/docs/programmatic-access/web-apis-overview
📖
Documentation
https://models.rcsb.org
📖
Documentation
https://maps.rcsb.org

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pdb/refs/heads/main/openapi/pdb-general-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/pdb-general-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pdb-general-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Pdb General API
  version: '1.0'
  description: 'Operations tagged General across 2 of this provider''s published API definitions: rcsb-pdb-model-server-api.json, rcsb-pdb-volume-server-api.json. Each path carries the servers of the definition it was published in.'
tags:


# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pdb/refs/heads/main/openapi/pdb-general-api-openapi.yml