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.
All 92 tools

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 email required.

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

OpenAPI Specification

pdb-search-service-api-openapi.yml Raw ↑
openapi: 3.0.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.
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