OpenCitations Editors API
Operations for retrieving works by editor
OpenAPI Specification
openapi: 3.0.3
info:
title: OpenCitations Index REST Authors Editors API
description: 'REST API for accessing the data stored in the OpenCitations Index. Provides operations to retrieve citation data for references to other works appearing in a particular bibliographic entity, or citation data for references in other works to a particular bibliographic entity, given the identifier of a bibliographic entity, or to retrieve citation data about a particular citation identified by means of its Open Citation Identifier (OCI).
All operations return either a JSON document (default) or a CSV document according to the mimetype specified in the Accept header of the request.
API calls are rate-limited to 180 requests/minute per IP address. For large-scale retrieval use the database dumps at download.opencitations.net.
'
version: 2.2.0
contact:
name: OpenCitations
email: contact@opencitations.net
url: https://opencitations.net
license:
name: Creative Commons Attribution 4.0 International
url: https://creativecommons.org/licenses/by/4.0/legalcode
x-api-created: '2025-04-15'
servers:
- url: https://api.opencitations.net/index/v2
description: OpenCitations Index API v2
security:
- accessToken: []
- {}
tags:
- name: Editors
description: Operations for retrieving works by editor
paths:
/editor/{id}:
get:
summary: Get works by editor
operationId: getWorksByEditor
description: 'Retrieves the bibliographic metadata for each bibliographic entity edited by the person identified by the given ORCID or OpenCitations Meta Identifier (OMID).
Fields returned: id, title, author, pub_date, issue, volume, venue, page, type, publisher, editor.
'
tags:
- Editors
parameters:
- name: id
in: path
required: true
description: 'ORCID or OMID of the editor. Example: orcid:0000-0003-2098-4759
'
schema:
type: string
example: orcid:0000-0003-2098-4759
- $ref: '#/components/parameters/require'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/json'
responses:
'200':
description: Bibliographic metadata for works edited by the person
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BibliographicMetadata'
text/csv:
schema:
type: string
'404':
description: Editor not found
components:
schemas:
BibliographicMetadata:
type: object
description: Bibliographic metadata for a scholarly work
properties:
id:
type: string
description: 'Space-separated list of identifiers for the bibliographic entity. May include doi, isbn, issn, openalex, omid, pmid, pmcid values.
'
example: doi:10.1007/978-1-4020-9632-7 isbn:9781402096327 omid:br/0612058700
title:
type: string
description: Title of the bibliographic entity
example: Adaptive Environmental Management
author:
type: string
description: 'Semicolon-separated list of authors with their identifiers in brackets. Format: FamilyName, GivenName [orcid:... omid:ra/...]
'
example: Peroni, Silvio [orcid:0000-0003-0530-4305 omid:ra/0610122312]
pub_date:
type: string
description: Publication date (ISO 8601 or partial date)
example: '2009'
issue:
type: string
description: Issue number of the publication
example: '1'
volume:
type: string
description: Volume number of the publication
example: '42'
venue:
type: string
description: Title of the publication venue with identifiers in brackets
example: Scientometrics [issn:0138-9130 omid:br/0612058701]
page:
type: string
description: Starting and ending page numbers
example: 1-25
type:
type: string
description: Type of the bibliographic entity
enum:
- book
- book chapter
- book part
- book section
- book series
- book set
- book track
- component
- dataset
- dissertation
- edited book
- journal
- journal article
- journal issue
- journal volume
- monograph
- other
- peer review
- posted content
- proceedings
- proceedings article
- proceedings series
- reference book
- reference entry
- report
- report series
- standard
- standard series
example: book
publisher:
type: string
description: Publisher name with identifiers in brackets
example: Springer Science And Business Media Llc [crossref:297 omid:ra/0610116006]
editor:
type: string
description: 'Semicolon-separated list of editors with their identifiers in brackets. Format: FamilyName, GivenName [orcid:... omid:ra/...]
'
example: Allan, Catherine [orcid:0000-0003-2098-4759 omid:ra/069012996]
parameters:
filter:
name: filter
in: query
required: false
description: 'Applies conditional filtering. Supports regex or operators (=, <, >). Format: field:operator:value. Example: date:>2015
'
schema:
type: string
example: date:>2015
format:
name: format
in: query
required: false
description: Output format. Accepts "csv" or "json" (default).
schema:
type: string
enum:
- json
- csv
default: json
sort:
name: sort
in: query
required: false
description: 'Orders results by field in ascending or descending order. Format: asc(field) or desc(field).
'
schema:
type: string
example: desc(pub_date)
json:
name: json
in: query
required: false
description: 'Transforms JSON data structure. Supports array splitting or dict conversion.
'
schema:
type: string
require:
name: require
in: query
required: false
description: Removes rows with empty values in the specified field
schema:
type: string
example: doi
securitySchemes:
accessToken:
type: apiKey
in: header
name: authorization
description: 'OpenCitations Access Token obtained from https://opencitations.net/accesstoken. Recommended for application/code usage to ensure stable access.
'
externalDocs:
description: OpenCitations Index API Documentation
url: https://api.opencitations.net/index/v2