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/datacite-reports-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: Datacite Reports API
version: '1.0'
description: 'Operations tagged reports across 2 of this provider''s published API definitions: datacite-rest-api-openapi.yml, datacite-usage-reports-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.test.datacite.org
description: Staging server
- url: https://api.datacite.org
description: Production server
- url: https://metrics.stage.datacite.org
description: Staging server
tags:
- name: reports
description: Reports
paths:
/reports:
get:
tags:
- reports
summary: A JSON array of reports.
security: []
parameters:
- in: query
name: platform
description: Name of the Platform the usage is being requested for. This can be omitted if the service provides usage for only one platform.
schema:
type: string
- in: query
name: report-name
description: The long name of the report.
schema:
type: string
- in: query
name: report-id
description: The report ID or code or shortname. Typically this will be the same code provided in the Report parameter of the request.
schema:
type: string
- in: query
name: release
description: The release or version of the report.
schema:
type: string
- in: query
name: created
description: Time the report was prepared. Format as defined by date-time - RFC3339
schema:
type: string
format: date-time
- in: query
name: created-by
description: Name of the organization producing the report.
schema:
type: string
- in: query
$ref: '#/components/parameters/pageNumberParam'
- in: query
$ref: '#/components/parameters/pageSizeParam'
responses:
'200':
description: A JSON array of reports.
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Report'
meta:
type: object
properties:
total:
description: Total results count.
type: number
total-pages:
description: Total pages count.
type: number
page:
description: Current page of the results.
type: number
post:
tags:
- reports
summary: Add a new report.
security:
- BasicAuth: []
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Report'
responses:
'201':
description: Created
servers:
- url: https://api.test.datacite.org
description: Staging server
- url: https://api.datacite.org
description: Production server
/reports/{id}:
get:
parameters:
- name: id
in: path
description: Report
required: true
schema:
type: string
tags:
- reports
summary: Return a report.
responses:
'200':
description: A JSON object.
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
type: object
$ref: '#/components/schemas/Report'
security:
- {}
- BasicAuth: []
- bearerAuth: []
put:
parameters:
- name: id
in: path
description: Report
required: true
schema:
type: string
tags:
- reports
summary: Update a report.
security:
- BasicAuth: []
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Report'
responses:
'200':
description: OK
delete:
summary: This resource deletes a specific Dataset report.
tags:
- reports
parameters:
- name: id
in: path
description: Report Unique ID. Identifier of a specific usage report is being deleted. If omitted, there should be a error.
required: true
schema:
type: string
responses:
'204':
description: The resource was deleted successfully.
default:
description: unexpected error
content:
application/json:
schema:
$ref: '#/definitions/Error_Model'
security:
- {}
- BasicAuth: []
- bearerAuth: []
servers:
- url: https://api.test.datacite.org
description: Staging server
- url: https://api.datacite.org
description: Production server
components:
schemas:
Report:
type: object
description: Describes the formatting needs for the COUNTER Dataset Report. Response may include the Report_Header (optional), Report_Datasets (usage stats).
properties:
id:
type: string
example: 003fadc1-daab-4d1e-97d1-96004c1ff529
report-header:
type: object
required:
- report-id
- report-name
- release
- created-by
- reporting-period
properties:
report-name:
type: string
description: The long name of the report.
example: Dataset Report
report-id:
type: string
description: The report ID or code or shortname. Typically this will be the same code provided in the Report parameter of the request.
example: DSR
release:
type: string
description: The release or version of the report.
example: RD1
created-by:
type: string
description: Name of the organization producing the report.
example: DataONE
created:
type: string
format: dateTime
description: Time the report was prepared. Format as defined by date-time - RFC3339
example: '2019-09-08T22:47:31Z'
reporting-period:
description: Time the report was prepared.
type: object
properties:
end-date:
type: string
example: 2018-04-30
begin-date:
type: string
example: 2018-04-01
report-filters:
description: Zero or more report filters used for this report. Typically reflect filters provided on the Request. Filters limit the data to be reported on.
type: array
items:
type: string
report-attributes:
description: Zero or more additional attributes applied to the report. Attributes inform the level of detail in the report.
type: array
items:
type: string
exceptions:
readOnly: true
type: array
items:
type: object
properties:
code:
type: number
data:
type: string
message:
type: string
help-url:
type: string
severity:
type: string
report-datasets:
description: Defines the output for the Report_Datasets being returned in a Dataset Report. Collection of datasets from the report.
type: array
items:
type: object
properties:
uri:
type: string
example: https://cn.dataone.org/cn/v2/resolve/doi%3A10.5063%2FAA%2Fnceas.985.1
yop:
type: string
description: Year of publication in the format of 'yyyy'. Use '0001' for unknown and '9999' for articles in press.
example: '2010'
platform:
type: string
description: Name of the platform.
example: DataONE
data-type:
type: string
description: Nature of the dataset being reported.
example: dataset
publisher:
type: string
description: Name of publisher of the dataset.
example: DataONE
dataset-id:
type: array
description: The identifier for the report dataset.
items:
type: object
properties:
type:
type: string
example: doi
value:
type: string
example: 10.15146/R3J66V
performance:
type: array
items:
type: object
properties:
period:
type: object
properties:
end-date:
type: string
example: 2018-04-30
begin-date:
type: string
example: 2018-04-01
instance:
type: array
items:
type: object
properties:
count:
type: number
example: 20
metric-type:
type: string
description: Type of activity being counted.
example: unique-dataset-requests
enum:
- total-dataset-requests
- unique-dataset-requests
- total-dataset-investigations
- unique-dataset-investigations
access-method:
type: string
description: Identifies if the usage activity was 'Regular' usage - a user doing research on a content site, or if the usage activity was 'Machine' - for the purpose of retrieving content for Text and Data Mining (TDM).
example: regular
enum:
- regular
- machine
publisher-id:
type: array
items:
type: object
properties:
type:
type: string
example: ror
value:
type: string
example: https://ror.org/04wxnsj81
dataset-dates:
type: array
items:
type: object
properties:
type:
type: string
example: pub-date
enum:
- pub-date
- first-accessed-online
- proprietary
value:
type: string
example: 2017-12-31
dataset-title:
type: string
description: Name of the dataset being reported.
example: Lake Erie Fish Community Data
dataset-contributors:
type: array
description: The identifier for contributor (i.e. creator) of the dataset.
items:
type: object
properties:
type:
type: string
example: name
enum:
- name
- orcid
- isni
value:
type: string
description: Value of the contributor identifier.
example: Cassandra Lopez
report-subsets:
type: array
items:
type: object
properties:
gzip:
type: string
checksum:
type: string
required:
- report-datasets
parameters:
pageNumberParam:
name: page[number]
in: query
schema:
type: integer
description: Page number for [pagination](https://support.datacite.org/docs/pagination).
pageSizeParam:
name: page[size]
in: query
schema:
type: integer
minimum: 0
maximum: 1000
description: Page size between 0 and 1,000 for [pagination](https://support.datacite.org/docs/pagination).
securitySchemes:
BasicAuth:
type: http
scheme: basic
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
Bearer:
type: http
scheme: bearer
description: Token-based authentication for members
x-refined-from:
- datacite-rest-api-openapi.yml
- datacite-usage-reports-api-openapi.yml