--- title: "search serial meta data by descriptive field names" method: GET path: "/serial/_structured_search" tags: ["v1 serial"] --- # search serial meta data by descriptive field names `GET /serial/_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 - **title: 'Annals of Mathematics'**: Search for journal title phrase - **year: '1800-1899'**: Search for 19th century serials # Search fields - **Anywhere**: Includes cc, cy, jt, la, li, pu, sn - **Country**: Country of the publisher (use name, e.g., cy:France, or ISO 3166-1 codes, e.g., cy:FR) - **ISSN**: International Standard Serial Number (ISSN) - **Language**: Languages of indexed documents (la:French, or ISO 639-1 codes, e.g., la:FR) - **Main fields**: Main fields of the serial (given by first two MSC digits) - **Publisher**: Name/location of the publisher or editorial institution - **Serial ID**: zbMATH serial ID - **Serial type**: Type: journal (tp:j), book series (tp:b) - **State**: State: open access (st:o), currently indexed (st:v), indexed cover to cover (st:t), is cited (st:c), has references (st:r) - **Title**: Title, acronym or short title - **URL**: External link (URL) - **Year**: Time period the serial has been active (interval search with “-”) ## Query parameters - `page` integer — pagination for result page - `results_per_page` integer - `Anywhere` string — Includes cc, cy, jt, la, li, pu, sn - `Country` string — Country of the publisher (use name, e.g., cy:France, or ISO 3166-1 codes, e.g., cy:FR) - `ISSN` string — International Standard Serial Number (ISSN) - `Language` string — Languages of indexed documents (la:French, or ISO 639-1 codes, e.g., la:FR) - `Main fields` string — Main fields of the serial (given by first two MSC digits) - `Publisher` string — Name/location of the publisher or editorial institution - `Serial ID` string — zbMATH serial ID - `Serial type` string — Type: journal (tp:j), book series (tp:b) - `State` string — State: open access (st:o), currently indexed (st:v), indexed cover to cover (st:t), is cited (st:c), has references (st:r) - `Title` string — Title, acronym or short title - `URL` string — External link (URL) - `Year` string — Time period the serial has been active (interval search with “-”) ## Response `200` Successful Response - ZbmathdatamodelsDisplaySerialResultSearch - `result` Serial[] - `acronym` string - `comments` unknown[] - unknown - `countries` WhichCountry[] - `code` string - `country` 'International Institute for Applied Systems Analysis (IIASA)' | 'Eritrea' | 'Mayotte' | 'South Georgia and the South Sandwich Islands' | 'France, Metropolitan' | 'Andorra' | 'Not defined' | 'United Arab Emirates' | 'Afghanistan' | 'Antigua and Barbados' | 'Albania' | 'Angola' | 'Argentina' | 'Austria' | 'Australia' | 'Barbados' | 'Bangladesh' | 'Belgium' | 'Burkina Faso' | 'Bulgaria' | 'Bahrain' | 'Burundi' | 'Benin' | 'Bermuda' | 'Brunei Darussalam' | 'Bolivia' | 'Brazil' | 'Bahamas' | 'Bhutan' | 'Burma' | 'Botswana' | 'Belarus' | 'Belize' | 'Canada' | 'Central African Republic' | 'Congo' | 'Switzerland' | 'Cote d'Ivoire' | 'Chile' | 'Cameroon' | 'China' | 'Colombia' | 'Costa Rica' | 'Cuba' | 'Cape Verde' | 'Cyprus' | 'German Democratic Republic' | 'Germany' | 'Djibouti' | 'Denmark' | 'Dominica' | 'Dominican Republic' | 'Algeria' | 'Ecuador' | 'Egypt' | 'Spain' | 'Ethiopia' | 'Finland' | 'Fiji' | 'France' | 'Gabon' | 'United Kingdom' | 'Grenada' | 'Ghana' | 'Gambia' | 'Guinea' | 'Equatorial Guinea' | 'Greece' | 'Guatemala' | 'Guinea-Bissau' | 'Guyana' | 'Hong Kong' | 'Honduras' | 'Haiti' | 'Hungary' | 'Indonesia' | 'Ireland' | 'Israel' | 'India' | 'Iraq' | 'Iran (Islamic Republic of)' | 'Iceland' | 'Italy' | 'Jamaica' | 'Jordan' | 'Japan' | 'Kenya' | 'Cambodia' | 'Kiribati' | 'Comoros' | 'Korea, Democratic People's Republic of' | 'Korea, Republic of' | 'Kuwait' | 'Lao People's Democratic Republic' | 'Lebanon' | 'Sainte-Lucie' | 'Liechtenstein' | 'Sri Lanka' | 'Liberia' | 'Lesotho' | 'Luxembourg' | 'Libyan Arab Jamahiriya' | 'Morocco' | 'Monaco' | 'Madagascar' | 'Mali' | 'Mongolia' | 'Mauritania' | 'Malta' | 'Mauritius' | 'Maldives' | 'Malawi' | 'Mexico' | 'Malaysia' | 'Mozambique' | 'Niger' | 'Nigeria' | 'Nicaragua' | 'Netherlands' | 'Norway' | 'Nepal' | 'Nauru' | 'New Zealand' | 'Oman' | 'Panama' | 'Peru' | 'Papua New Guinea' | 'Philippines' | 'Pakistan' | 'Poland' | 'Puerto Rico' | 'Portugal' | 'Paraguay' | 'Qatar' | 'Romania' | 'Rwanda' | 'Saudi Arabia' | 'Solomon Islands' | 'Seychelles' | 'Sudan' | 'Sweden' | 'Singapore' | 'Sierra Leone' | 'San Marino' | 'Senegal' | 'Somalia' | 'Suriname' | 'Sao Tome and Principe' | 'USSR' | 'El Salvador' | 'Syrian Arab Republic' | 'Swaziland' | 'Chad' | 'Togo' | 'Thailand' | 'Tunisia' | 'Tonga' | 'Turkey' | 'Trinidad and Tobago' | 'Tuvalu' | 'Tanzania, United Republic of' | 'Ukraine' | 'Uganda' | 'United States of America' | 'Uruguay' | 'Vatican City State' | 'Saint Vincent and the Grenadines' | 'Venezuela' | 'Viet Nam' | 'Vanuatu' | 'Samoa' | 'Yemen, Democratic' | 'Yemen' | 'Yugoslavia' | 'South Africa' | 'Zambia' | 'Zaire' | 'Zimbabwe' | 'Serbia and Montenegro' | 'Anguilla' | 'Netherlands Antilles' | 'Antarctica' | 'American Samoa' | 'Aruba' | 'Bouvet Island' | 'Cocos (Keeling) Islands' | 'Myanmar' | 'Cook Islands' | 'Christmas Island' | 'Western Sahara' | 'Falkland Islands (Malvinas)' | 'Micronesia (Federated States of)' | 'Faroe Islands' | 'French Guiana' | 'Gibraltar' | 'Greenland' | 'Guadeloupe' | 'Guam' | 'Heard Island and McDonald Islands' | 'British Indian Ocean Territory' | 'Saint Kitts and Nevis' | 'Cayman Islands' | 'Marshall Islands' | 'Montserrat' | 'Namibia' | 'Norfolk Island' | 'Macau' | 'Northern Mariana Islands' | 'Martinique' | 'Niue' | 'French Polynesia' | 'Saint Pierre and Miquelon' | 'Pitcairn' | 'Palau' | 'Reunion' | 'Saint Helena' | 'Svalbard and Jan Mayen Islands' | 'Turks and Caicos Islands' | 'French Southern Territories' | 'Tokelau' | 'East Timor' | 'Taiwan, Province of China' | 'United States Minor Outlying Islands' | 'Wallis and Futuna Islands' | 'Virgin Islands (British)' | 'Virgin Islands (U.S.)' | 'Lithuania' | 'New Caledonia' | 'International Atomic Energy Agency (IAEA)' | 'European Organization for Nuclear Research (CERN)' | 'OECD, Paris' | 'Commission of the European Communities (CEC)' | 'Food and Agriculture Organization of the UN (FAO)' | 'Joint Institute for Nuclear Research (JINR)' | 'Council for Mutual Economic Assistance (CMEA)' | 'Nuclear Energy Agency of the OECD (NEA)' | 'International Commission on Radiological Protection (ICRP)' | 'International Organization for Standardization (ISO)' | 'United Nations (UN)' | 'World Health Organization (WHO)' | 'World Energy Conference (WEC)' | 'International Energy Agency (IEA)' | 'Armenia' | 'Azerbaijan' | 'Estonia' | 'Georgia' | 'Croatia' | 'Kyrgyzstan' | 'Kazakhstan' | 'Latvia' | 'Moldova, Republic of' | 'Neutral Zone' | 'Russian Federation' | 'Tajikistan' | 'Turkmenistan' | 'Uzbekistan' | 'Slovenia' | 'Arab Atomic Energy Agency' | 'International Organisations without Location' | 'Comprehensive Nuclear Test-ban Treaty Organization (CTBTO)' | 'United Nations Industrial Development Organization (UNIDO)' | 'Czech Republic' | 'Slovakia' | 'Bosnia and Herzegovina' | 'Euro' | 'Macedonia, the former Yugoslav Republic of' | 'Congo, the Democratic Republic of' | 'Occupied Palestinian Territory' | 'Kosovo' | 'Serbia' | 'Montenegro' — An enumeration. - `id` integer - `issn` ZbmathdatamodelsDisplaySerialSubmodelsISSN[] - `number` string - `type` 'electronic' | 'print' — An enumeration. - `languages` Languages - `documents` WhichLanguage[] - `code` string - `language` 'Afrikaans' | 'Arabic' | 'Bulgarian' | 'Byelorussian' | 'Chinese' | 'Czech' | 'Danish' | 'Dutch' | 'English' | 'Finnish' | 'French' | 'German' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Lithuanian' | 'Malay' | 'Norwegian' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Serbo-Croat' | 'Slovak' | 'Spanish' | 'Swedish' | 'Thai' | 'Turkish' | 'Ukrainian' | 'Welsh' | 'Punjabi' | 'Urdu' | 'Polyglott?' | 'Not defined' | 'Tamil' | 'Greek' | 'Hebrew' | 'Slovenian' | 'Latin' | 'Georgian' | 'Serbian' | 'Moldavian' | 'Latvian' | 'Estonian' | 'Catalan' | 'Azerbaijani' | 'Esperanto' | 'Croatian' | 'Macedonian' | 'Vietnamese' | 'Frisian' | 'Sanskrit' | 'Basque' | 'Icelandic' | 'Aymara' | 'Bashkir' | 'Bihari' | 'Bislama' | 'Bengali' | 'Tibetan' | 'Corsican' | 'Javanese' | 'Samoan' | 'Faroese' | 'Mongolian' | 'Irish' | 'Scots Gaelic' | 'Galician' | 'Breton' | 'Afar' | 'Abkhazian' | 'Amharic' | 'Assamese' | 'Armenian' | 'Turkmen' | 'Kazakh' | 'Uzbek' | 'Interlingua' | 'Albanian' | 'language not recognized' — An enumeration. - `abstracts` WhichLanguage[] - `code` string - `language` 'Afrikaans' | 'Arabic' | 'Bulgarian' | 'Byelorussian' | 'Chinese' | 'Czech' | 'Danish' | 'Dutch' | 'English' | 'Finnish' | 'French' | 'German' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Lithuanian' | 'Malay' | 'Norwegian' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Serbo-Croat' | 'Slovak' | 'Spanish' | 'Swedish' | 'Thai' | 'Turkish' | 'Ukrainian' | 'Welsh' | 'Punjabi' | 'Urdu' | 'Polyglott?' | 'Not defined' | 'Tamil' | 'Greek' | 'Hebrew' | 'Slovenian' | 'Latin' | 'Georgian' | 'Serbian' | 'Moldavian' | 'Latvian' | 'Estonian' | 'Catalan' | 'Azerbaijani' | 'Esperanto' | 'Croatian' | 'Macedonian' | 'Vietnamese' | 'Frisian' | 'Sanskrit' | 'Basque' | 'Icelandic' | 'Aymara' | 'Bashkir' | 'Bihari' | 'Bislama' | 'Bengali' | 'Tibetan' | 'Corsican' | 'Javanese' | 'Samoan' | 'Faroese' | 'Mongolian' | 'Irish' | 'Scots Gaelic' | 'Galician' | 'Breton' | 'Afar' | 'Abkhazian' | 'Amharic' | 'Assamese' | 'Armenian' | 'Turkmen' | 'Kazakh' | 'Uzbek' | 'Interlingua' | 'Albanian' | 'language not recognized' — An enumeration. - `lineage` Lineage - `predecessors` unknown[] - unknown - `successors` unknown[] - unknown - `main_fields` ZbmathdatamodelsDisplaySerialSubmodelsMainField[] - `count` integer - `field` string - `percent` number - `percentile` number - `online_availability` string - `parallel_title` string - `publisher` string - `serial_type` 'book_series' | 'journal_series' — An enumeration. - `short_title` string - `states` State[] - `sub_series` unknown[] - unknown - `sub_title` string - `title` string - `translation` Translation - `translated_from` unknown[] - unknown - `translated_to` unknown[] - unknown - `urls` unknown[] - unknown - `zbmath_start` string - `zbmath_stop` string - `zbmath_years` unknown[] - unknown - `zbmath_url` string - `metadata` MetaData - `type` 'author' | 'classification' | 'document' | 'serial' | 'software' | 'undefined' — An enumeration. - `score` number - `data_source` 'ELASTIC' | 'DATABASE' | 'undefined' — An enumeration. - `censored_fields` 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)