RCSB PDB Search Service API
The Search Service API from RCSB PDB — 2 operation(s) for search service.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/pdb-search-service-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 0.9.12
title: ModelServer General Search Service API
description: The ModelServer is a service for accessing subsets of macromolecular model data.
servers:
- url: https://data.rcsb.org/rest/v1/core
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Search Service
paths:
/rcsbsearch/v2/query:
get:
tags:
- Search Service
summary: Released data search API endpoint allows you to perform GET requests with textual and scientific searches against current RCSB PDB entries
operationId: runJsonQueriesGet
parameters:
- name: json
in: query
description: Search query. Must be URL-encoded.
required: true
schema:
$ref: schema/search/request/json-schema-rcsb_search_query.json
responses:
'200':
description: "OK.\n Request has succeeded."
content:
application/json:
schema:
$ref: schema/search/response/json-schema-rcsb_search_results.json
'400':
description: "Bad Request.\n The server cannot process the request due to malformed request or invalid query syntax"
content:
application/json:
schema:
type: object
'404':
description: "Not found.\n The requested resource was not found"
content:
application/json:
schema:
type: object
'415':
description: "Unsupported Media Type.\n The server refuses to accept the request because the payload format is in an unsupported format"
content:
application/json:
schema:
type: object
'501':
description: "Not Implemented.\n The server does not support the functionality required to fulfill the request"
content:
application/json:
schema:
type: object
'408':
description: "Request Timeout.\n The server did not receive complete results within the time that it was prepared to wait"
content:
application/json:
schema:
type: object
'500':
description: "Internal Server Error.\n The server encountered unexpected error"
content:
application/json:
schema:
type: object
'204':
description: "No Content.\n The server successfully processed the request and did not return any results"
content:
application/json:
schema:
type: object
'503':
description: "Service Unavailable.\n The server is currently unable to handle the request due to a temporary overloading"
content:
application/json:
schema:
type: object
post:
tags:
- Search Service
summary: Released data search API endpoint allows you to perform POST requests with textual and scientific searches against current RCSB PDB entries
operationId: runJsonQueriesPost
requestBody:
content:
application/json:
schema:
$ref: schema/search/request/json-schema-rcsb_search_query.json
required: true
responses:
'200':
description: "OK.\n Request has succeeded."
content:
application/json:
schema:
$ref: schema/search/response/json-schema-rcsb_search_results.json
'400':
description: "Bad Request.\n The server cannot process the request due to malformed request or invalid query syntax"
content:
application/json:
schema:
type: object
'404':
description: "Not found.\n The requested resource was not found"
content:
application/json:
schema:
type: object
'415':
description: "Unsupported Media Type.\n The server refuses to accept the request because the payload format is in an unsupported format"
content:
application/json:
schema:
type: object
'501':
description: "Not Implemented.\n The server does not support the functionality required to fulfill the request"
content:
application/json:
schema:
type: object
'408':
description: "Request Timeout.\n The server did not receive complete results within the time that it was prepared to wait"
content:
application/json:
schema:
type: object
'500':
description: "Internal Server Error.\n The server encountered unexpected error"
content:
application/json:
schema:
type: object
'204':
description: "No Content.\n The server successfully processed the request and did not return any results"
content:
application/json:
schema:
type: object
'503':
description: "Service Unavailable.\n The server is currently unable to handle the request due to a temporary overloading"
content:
application/json:
schema:
type: object
/rcsbsearch/v2/query/unreleased:
get:
tags:
- Search Service
summary: Unreleased data search API endpoint allows you to perform GET requests with textual searches against RCSB PDB unreleased entries
operationId: runUnreleasedEntryJsonQueries
parameters:
- name: json
in: query
description: Search query. Must be URL-encoded.
required: true
schema:
$ref: schema/unreleased/request/json-schema-rcsb_unreleased_query.json
responses:
'200':
description: "OK.\n Request has succeeded."
content:
application/json:
schema:
$ref: schema/unreleased/response/json-schema-rcsb_unreleased_results.json
'400':
description: "Bad Request.\n The server cannot process the request due to malformed request or invalid query syntax"
content:
application/json:
schema:
type: object
'404':
description: "Not found.\n The requested resource was not found"
content:
application/json:
schema:
type: object
'415':
description: "Unsupported Media Type.\n The server refuses to accept the request because the payload format is in an unsupported format"
content:
application/json:
schema:
type: object
'501':
description: "Not Implemented.\n The server does not support the functionality required to fulfill the request"
content:
application/json:
schema:
type: object
'408':
description: "Request Timeout.\n The server did not receive complete results within the time that it was prepared to wait"
content:
application/json:
schema:
type: object
'500':
description: "Internal Server Error.\n The server encountered unexpected error"
content:
application/json:
schema:
type: object
'204':
description: "No Content.\n The server successfully processed the request and did not return any results"
content:
application/json:
schema:
type: object
'503':
description: "Service Unavailable.\n The server is currently unable to handle the request due to a temporary overloading"
content:
application/json:
schema:
type: object