Read one performer
get_performerRead-onlyIdempotent
Retrieve a performer's catalogued record by identifier, with scene counts and selected sections. Clarifies coverage gaps and identifier redirects.
Instructions
Read one catalogued performer by its identifier. 'scene_count' counts what that catalogue has indexed: a settled record naming a career spanning decades can report none, and that states the catalogue's coverage, never a career. An identifier folded into another answers as a marker naming its successor.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Identifier as returned by another tool, such as stashdb:<uuid>. | |
| sections | No | Which blocks to load. Defaults to basic. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | No | ||
| urls | No | ||
| notes | Yes | ||
| gender | No | ||
| images | No | ||
| scenes | No | ||
| source | Yes | ||
| status | Yes | 'established' is a record the catalogue holds. 'merged' and 'deleted' are markers: the identifier resolves, and what comes back describes the record rather than the thing it once named. | |
| aliases | No | Stage names and variant spellings alike. | |
| country | No | ||
| created | No | ||
| studios | No | ||
| updated | No | ||
| appearance | No | ||
| birth_date | No | ||
| death_date | No | ||
| merged_ids | No | ||
| source_url | Yes | ||
| former_name | No | Present on a marker: the name the record carried. | |
| merged_into | No | Present on a marker: the identifier that continues this record. | |
| scene_count | No | Scenes this catalogue has indexed crediting this performer. A settled record naming a career spanning decades can report zero, which measures coverage and states nothing about a person's work. Null on a marker, since the count belongs to the record that continues it. | |
| retrieved_at | Yes | When this record came off the catalogue, ISO 8601. | |
| scenes_total | No | What the catalogue holds behind the one page this section shows. | |
| disambiguation | No | Free text telling two people apart. It reads and never parses. | |
| career_end_year | No | ||
| career_start_year | No | ||
| scene_count_means | No | ||
| scenes_unavailable | No | Why the section is missing, when it was asked for and could not be read. Its absence then says nothing about what the catalogue holds. |