rcsb_search_by_sequence
Find Protein Data Bank polymer entities matching a given sequence by similarity, using BLAST-like search.
Instructions
Find PDB polymer entities similar to a given sequence (MMseqs2, BLAST-like).
Args:
sequence: The query sequence in one-letter code.
sequence_type: "protein", "dna", or "rna".
identity_cutoff: Minimum sequence identity as a fraction 0-1 (e.g. 0.3 = 30%).
evalue_cutoff: Maximum E-value to report.
return_type: What to return (default "polymer_entity"); see the "Return types and
fetching details" note in the server instructions.
limit: Max hits (1-100). Returns polymer_entity IDs like "4HHB_1" — fetch their
details with rcsb_get_polymer_entities.
offset: Number of hits to skip, for paging; pass the response's next_offset back with
the same query to fetch the next page.
all_hits: Return the COMPLETE result set in one call (for an explicit "ALL ..." request);
ignores limit, can't be combined with offset, and is refused above 10000 hits.
Ignored when facets is set.
attributes: Optional structured filters AND/OR-combined with this match — a list of
AttributeFilter {attribute, operator, value, negation?, case_sensitive?} (e.g.
restrict to an organism or resolution). See rcsb_search_by_attribute /
rcsb_list_pdb_search_attributes for paths and operators.
logical_operator: Combine this match and the attribute conditions with "and"
(default) or "or".
facets: Optional aggregation specs to return a breakdown / distribution instead of hits
(see the faceting note in the server instructions for the spec).
group_by, group_by_ranking: Collapse redundant polymer_entity hits into clusters, one
representative each (needs return_type="polymer_entity") — see the grouping note in
the server instructions.
sort_by: Attribute path to order the hits by, replacing the default similarity ordering
(each hit's score is still returned); omit to keep it. Only SORTABLE attributes work:
those listing exact_match (strings) or equals (numbers/dates) in
rcsb_list_pdb_search_attributes; full-text-only attributes (e.g. struct.title) and
return_type="mol_definition" are rejected.
sort_direction: "asc" (default) or "desc"; applies only when sort_by is set.
Returns:
{total_count, returned, offset, has_more, next_offset, hits:[{id, score}],
editor}; with facets, instead returns {total_count, facets, editor}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| facets | No | ||
| offset | No | ||
| sort_by | No | ||
| all_hits | No | ||
| group_by | No | ||
| sequence | Yes | ||
| attributes | No | ||
| return_type | No | polymer_entity | |
| evalue_cutoff | No | ||
| sequence_type | No | protein | |
| sort_direction | No | asc | |
| identity_cutoff | No | ||
| group_by_ranking | No | ||
| logical_operator | No | and |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||