ETH Zurich – Swiss Federal Institute of Technology items API
The items API from ETH Zurich – Swiss Federal Institute of Technology — 5 operation(s) for items.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/eth-zurich-items-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Discovery bitstreams Items API
description: "The Discovery REST API provides access to over 30 million books, images, series, journals, and other materials from the ETH Library's Discovery Portal. \n\n➜ [OAS 3 Swagger Documentation](https://eth-library.github.io/apiplatform-swagger/discovery/v1/)\n\n➜ [ETH Library @ swisscovery Application](https://eth.swisscovery.slsp.ch/)"
version: 1.0.2
termsOfService: https://developer.library.ethz.ch/terms
contact:
name: API Management ETH Library
email: api@library.ethz.ch
url: https://library.ethz.ch
license:
url: https://developer.library.ethz.ch/terms
name: Bibliographic metadata that are not specifically marked are free for general use (Public Domain). Documents, images or other digital objects linked in metadata may be subject to other copyright restrictions. Whenever possible, the licence of the referenced digital objects is indicated in the metadata. In case of doubt, the licence can be inquired at api@library.ethz.ch.
servers:
- url: https://api.library.ethz.ch/discovery/v1/
description: Production
security:
- ApiKeyAuth: []
tags:
- name: items
paths:
/poi-items/{id}:
get:
tags:
- items
description: Returns a content item (e-rara, emaps, E-Pics, e-periodica etc) of a poi defined in the ETHorama database.
parameters:
- name: id
schema:
type: string
in: path
required: true
description: content item ID
- name: edges
schema:
type: boolean
in: query
required: false
description: 'Should the edges/relations to dossiers, routes and pois also be returned (default: true)?
Example: edges=false'
responses:
'200':
description: Returns content item
content:
application/json: {}
'400':
description: bad request
'500':
description: server error
/items:
get:
tags:
- items
summary: Retrieve all items from the repository.
description: Retrieve all items from the repository.
operationId: getItems
parameters:
- name: expand
in: query
description: Show additional data for the item.
style: form
explode: true
schema:
type: string
items:
type: string
enum:
- all
- metadata
- parentCollection
- parentCollectionList
- parentCommunityList
- bitstreams
- name: limit
in: query
description: The maximum amount of items shown.
schema:
type: integer
format: int32
- name: offset
in: query
description: The amount of items to skip.
schema:
type: integer
format: int32
- name: userIP
in: query
schema:
type: string
- name: userAgent
in: query
schema:
type: string
- name: xforwardedfor
in: query
schema:
type: string
responses:
200:
description: successful operation
/items/{item_id}:
get:
tags:
- items
summary: Retrieve a single item by using the internal DSpace item identifier.
description: Retrieve a single item by using the internal DSpace item identifier.
operationId: getItem
parameters:
- name: item_id
in: path
description: The identifier of the item.
required: true
schema:
type: integer
format: int32
- name: expand
in: query
description: Show additional data for the item.
style: form
explode: true
schema:
type: string
items:
type: string
enum:
- all
- metadata
- parentCollection
- parentCollectionList
- parentCommunityList
- bitstreams
responses:
200:
description: successful operation
/items/{item_id}/bitstreams:
get:
tags:
- items
summary: Retrieve a list of bitstreams for an item by using the internal DSpace item identifier.
description: Retrieve a list of bitstreams for an item by using the internal DSpace item identifier.
operationId: getItemBitstreams
parameters:
- name: item_id
in: path
description: The identifier of the item.
required: true
schema:
type: integer
format: int32
- name: limit
in: query
description: The maximum amount of bitstreams shown.
schema:
type: integer
format: int32
- name: offset
in: query
description: The amount of bitstreams to skip.
schema:
type: integer
format: int32
- name: userIP
in: query
schema:
type: string
- name: userAgent
in: query
schema:
type: string
- name: xforwardedfor
in: query
schema:
type: string
responses:
200:
description: successful operation
/items/{item_id}/metadata:
get:
tags:
- items
summary: Retrieve a list of metadata for an item by using the internal DSpace item identifier.
description: Retrieve a list of metadata for an item by using the internal DSpace item identifier.
operationId: getItemMetadata
parameters:
- name: item_id
in: path
description: The identifier of the item.
required: true
schema:
type: integer
format: int32
- name: userIP
in: query
schema:
type: string
- name: userAgent
in: query
schema:
type: string
- name: xforwardedfor
in: query
schema:
type: string
responses:
200:
description: successful operation
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: query
name: apikey
externalDocs:
description: OAS 3 Swagger Documentation
url: https://apidocs.library.ethz.ch/discovery/v1/