---
title: "search authors by descriptive field names"
method: GET
path: "/author/_structured_search"
tags: ["v1 author"]
---

# search authors by descriptive field names

`GET /author/_structured_search`

# Description

 
 
 For searching in zbMATH you may employ the Structured Search for convenient combination of all search fields. While similar to the 1-line syntax search, this endpoint offers much more convenience and transparency which fields are searched at the cost of search flexibility.
 # Examples 

 
 - **author_code: 'smith.ivan'**: Search for the author with the zbMATH code **smith.ivan**
- **author_name: 'Smith'**: Search for authors with the name **Smith**
- **collective: 'bass.hyman'**: Search for the names of the author collective(s) that the author with the zbMATH code **bass.hyman** is in.
- **in_collective: 'bourbaki.nicolas'**: Search for authors that are in the author collective with the zbMATH code **bourbaki.nicolas**

# Search fields

 
 - **Anywhere**: Includes ai, au, cc
- **Author code**: zbMATH author code
- **Author name**: Author name
- **Award**: Name or year of an award (to find laureates)
- **Collective code**: Code of a collective (to find members of this collective)
- **External ID**: External author ID: ORCID, MGP, Wikidata object number, and others
- **Family name**: Family name
- **Given name**: Given name
- **Main fields**: Main fields of the author (given by first two MSC digits)
- **Reviewer ID**: Reviewer ID
- **State**: State: has biographic references (<em>st:b</em>), is cited (<em>st:c</em>), is collective (<em>st:o</em>), is reviewer (<em>st:z</em>)
- **Year**: Year(s) in which the author has published (interval search with &ldquo;-&rdquo;)

## Query parameters

- `page` integer — pagination for result page
- `results_per_page` integer
- `Anywhere` string — Includes ai, au, cc
- `Author code` string — zbMATH author code
- `Author name` string — Author name
- `Award` string — Name or year of an award (to find laureates)
- `Collective code` string — Code of a collective (to find members of this collective)
- `External ID` string — External author ID: ORCID, MGP, Wikidata object number, and others
- `Family name` string — Family name
- `Given name` string — Given name
- `Main fields` string — Main fields of the author (given by first two MSC digits)
- `Reviewer ID` string — Reviewer ID
- `State` string — State: has biographic references (<em>st:b</em>), is cited (<em>st:c</em>), is collective (<em>st:o</em>), is reviewer (<em>st:z</em>)
- `Year` string — Year(s) in which the author has published (interval search with &ldquo;-&rdquo;)

## Response `200`

Successful Response

- ZbmathdatamodelsDisplayAuthorResultSearch
  - `result` ZbmathdatamodelsDisplayAuthorAuthor[]
    - `aliases` unknown[]
      - unknown
    - `awards` Award[]
      - `title` string
      - `wikidata` WikiData
        - `id` string
        - `link` string
      - `year` integer
    - `code` string
    - `collective_of` unknown[]
      - unknown
    - `external_ids` ExternalID[]
      - `external_id` string
      - `type` 'arxiv' | 'carmin_tv' | 'celebratio' | 'dblp' | 'email' | 'gnd' | 'google_scholar' | 'homepage' | 'idref' | 'ieee' | 'mactutor' | 'mathnetru' | 'mathoverflow' | 'mathscinet' | 'mgp' | 'orcid' | 'researchgate' | 'riddle' | 'theses_fr' | 'twitter' | 'viaf' | 'wikidata' | 'zbl_reviewer' | '' — An enumeration.
    - `further_spellings` FurtherSpelling[]
      - `charset` string
      - `name` string
    - `main_fields` ZbmathdatamodelsDisplayAuthorSubmodelsMainField[]
      - `count` integer
      - `field` string
      - `percent` string
      - `percentile` string
    - `in_collective` unknown[]
      - unknown
    - `name` string
    - `reviewer` string
    - `spellings` Spelling[]
      - `count` integer
      - `first_name` string
      - `initials` string
      - `last_name` string
      - `name` string
    - `states` State[]
    - `zbmath_url` string
  - `status` Status
    - `execution` string, required
    - `execution_bool` boolean, required
    - `internal_code` string
    - `last_id` integer
    - `nr_total_results` integer
    - `nr_request_results` integer
    - `query_execution_time_in_seconds` number
    - `status_code` integer, required
    - `time_stamp` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/zbmath/apis/rest-api-for-zbmath-open-v1.md) · [All operations](https://skmtc.dev/zbmath/apis/rest-api-for-zbmath-open-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zbmath/rest-api-for-zbmath-open-v1/revisions/1fcb04bb318a/schema)