Figshare

App · 15 actions

Find and read the research published on Figshare from a workflow: datasets, figures, papers, posters, code and theses from universities, publishers and researchers worldwide. Search by words, research category, kind of item, institution and publication date; read an item's title, authors, DOI, licence, categories, citation and description as plain text; list its versions and its files with direct download links; and browse collections and projects with the items in them. Every action reads public records: nothing here changes anything. No account or API key required.

Actions

ActionWhat it does
Get a collectionRead one public Figshare collection: its title, authors, DOI, description as plain text, categories, keywords, the paper it supports, a ready-made citation, how many items it holds and the institution that published it.
Get a projectRead one public Figshare project: its title, description as plain text, funding, collaborators and their roles, and its page link.
Get an articleRead one public Figshare item in full: its title, authors with their ORCID iDs, DOI, licence, categories, keywords, funding, related papers and a ready-made citation, its description as plain text (with the original HTML beside it), and every file with its size and a direct download link.
Get an article fileRead one file of a Figshare item: its name, type, size, MD5 checksum and direct download link.
List a collection's articlesList the public items in a Figshare collection, each with its number, title, kind, DOI and page link, ready for 'Get an article' or 'List an article's files'.
List a collection's versionsList every public version of a Figshare collection, oldest first, with the latest version's number, so a workflow can notice when a collection has been updated.
List a project's articlesList the public items in a Figshare project, each with its number, title, kind, DOI and page link, ready for 'Get an article'.
List an article's filesList the files of a Figshare item, at its latest version or an earlier one, each with its name, type, size, checksum and a direct download link that needs no account.
List an article's versionsList every public version of a Figshare item, oldest first, with the latest version's number and a link that downloads each version's files as one archive.
List categoriesList the research categories Figshare files items under, from the Fields of Research classification, each with the broader category it belongs to and its code.
List item typesList the kinds of item figshare.com accepts, such as dataset, figure and thesis, with what Figshare says each is for and the value the item type filter on 'Search articles' takes.
List licencesList the licences public Figshare items are published under, such as CC BY 4.0 and CC0, each with a link to its terms.
Search articlesFind public research on Figshare: datasets, figures, papers, posters, code, theses and more.
Search collectionsFind public Figshare collections: curated sets of items, such as all the data behind one paper or a journal's supplementary material.
Search projectsFind public Figshare projects: the shared spaces where a research group publishes the items from one piece of work.

Get a collection

Read one public Figshare collection: its title, authors, DOI, description as plain text, categories, keywords, the paper it supports, a ready-made citation, how many items it holds and the institution that published it. Give its number, DOI or link, and a version number to read an earlier version.

Inputs

CollectioncollectiontextRequired
Which collection: its Figshare number, its DOI, or the link to its page. 'Search collections' returns the number.
Versionversionnumber
Which version of the collection to read. Leave it empty for the latest. 'List a collection's versions' lists the version numbers.From 1 to 1000.

Outputs

article_countnumber
How many articles it holds.
author_nameslist
The authors' names, in order.
authorslist
The authors, in the order they are credited.
categorieslist
The research categories it is filed under.
citationtext
A ready-made citation, with the DOI link.
created_datetext
When it was created, as an ISO 8601 UTC time.
descriptiontext
The description as plain text, paragraphs kept.
description_htmltext
The description exactly as deposited.
doitext
The DOI of this version.
doi_urltext
The DOI as a https://doi.org/ link, which opens its page.
first_onlinetext
When the first version went online, as YYYY-MM-DD.
fundinglist
The grants and funders it credits.
group_idnumber
The group within the institution that published it.
idnumber
The collection's Figshare number.
institution_idnumber
The institution that published it. 'Search articles' takes this number to search that institution's items.
matched_bytext
How the collection was found from what was given: id, doi or link.
modified_datetext
When it last changed, as an ISO 8601 UTC time.
published_datetext
When this version was published, as an ISO 8601 UTC time.
referenceslist
Links to works it references.
related_materialslist
Related papers and works, with how each relates.
resource_doitext
That paper's DOI, when given.
resource_titletext
The title of the paper it supports, when given.
tagslist
The keywords its authors gave it.
titletext
The title as plain text, on one line.
title_htmltext
The title exactly as deposited.
versionnumber
Which version this is.
Example output
{
  "article_count": 18,
  "author_names": [
    "Yidan Chen",
    "Fang Guo"
  ],
  "authors": [
    {
      "figshare_author_id": 640460,
      "name": "Yidan Chen",
      "orcid_id": null
    },
    {
      "figshare_author_id": 105824,
      "name": "Fang Guo",
      "orcid_id": null
    }
  ],
  "categories": [
    "Climate Change Processes",
    "Population Trends and Policies"
  ],
  "citation": "Chen, Yidan; Guo, Fang; Wang, Jiachen; Cai, Wenjia; Wang, Can; Wang, Kaicun (2020). Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100. figshare. Collection. https://doi.org/10.6084/m9.figshare.c.4605713.v1",
  "created_date": "2020-03-02T10:40:08Z",
  "description": "Here we uploaded the R code used and results developed in the manuscript: \"Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100\".",
  "description_html": "Here we uploaded the R code used and results developed in the manuscript: \"Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100\".",
  "doi": "10.6084/m9.figshare.c.4605713.v1",
  "doi_url": "https://doi.org/10.6084/m9.figshare.c.4605713.v1",
  "first_online": "2020-03-02",
  "funding": [],
  "group_id": 2826,
  "id": 4605713,
  "institution_id": 81,
  "matched_by": "id",
  "modified_date": "2020-03-02T10:40:22Z",
  "published_date": "2020-03-02T10:40:08Z",
  "references": [
    "https://doi.org/10.1038/s41597-020-0421-y"
  ],
  "related_materials": [
    {
      "identifier": "10.1038/s41597-020-0421-y",
      "identifier_type": "DOI",
      "link": "https://doi.org/10.1038/s41597-020-0421-y",
      "relation": "IsSupplementTo",
      "title": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100"
    }
  ],
  "resource_doi": "10.1038/s41597-020-0421-y",
  "resource_title": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100",
  "tags": [
    "Shared Socioeconomic Pathways (SSPs)",
    "Climate Change",
    "China"
  ],
  "title": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100",
  "title_html": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100",
  "version": 1
}

Get a project

Read one public Figshare project: its title, description as plain text, funding, collaborators and their roles, and its page link.

Inputs

ProjectprojecttextRequired
Which project: its Figshare number or the link to its page. Projects have no DOI. 'Search projects' returns the number.

Outputs

collaboratorslist
The people working on it.
created_datetext
When it was created, as an ISO 8601 UTC time.
custom_fieldslist
Extra details the institution asks its projects for.
descriptiontext
The description as plain text, paragraphs kept.
description_htmltext
The description exactly as written, as HTML.
fundinglist
The grants and funders it credits.
idnumber
The project's Figshare number.
matched_bytext
How the project was found: id or link.
modified_datetext
When it last changed, as an ISO 8601 UTC time.
published_datetext
When it was published, as an ISO 8601 UTC time.
titletext
The title as plain text, on one line.
urltext
The project's page on figshare.com.
Example output
{
  "collaborators": [
    {
      "figshare_user_id": 4941850,
      "name": "Yuchuan Lai",
      "role": "Owner"
    }
  ],
  "created_date": "2019-03-25T20:58:11Z",
  "custom_fields": [],
  "description": "This is the data repository for the \"Use of Historical Data to Assess Regional Climate Change\". Two separate datasets are available: 1) time series of historical daily temperature and precipitation at different U.S. cities; 2) time series of historical annual temperature and precipitation index calculations at different cities.",
  "description_html": "<p>This is the data repository for the \"Use of Historical Data to Assess Regional Climate Change\". Two separate datasets are available: 1) time series of historical daily temperature and precipitation at different U.S. cities; 2) time series of historical annual temperature and precipitation index calculations at different cities.</p>",
  "funding": [
    "Carnegie Mellon College of Engineering Dean\u2019s Fellowship to Yuchuan Lai, and by the Hamerschlag Chair of Professor Dzombak."
  ],
  "id": 61538,
  "matched_by": "id",
  "modified_date": "2024-08-21T21:56:17Z",
  "published_date": "2019-04-05T19:45:33Z",
  "title": "Use of historical data to assess regional climate change",
  "url": "https://figshare.com/projects/Use_of_historical_data_to_assess_regional_climate_change/61538"
}

Get an article

Read one public Figshare item in full: its title, authors with their ORCID iDs, DOI, licence, categories, keywords, funding, related papers and a ready-made citation, its description as plain text (with the original HTML beside it), and every file with its size and a direct download link. Give its number, its DOI or its page link, and a version number to read an earlier version.

Inputs

ArticlearticletextRequired
Which article: its Figshare number, its DOI, or the link to its page on figshare.com or an institution's Figshare portal. 'Search articles' returns the number.
Versionversionnumber
Which version of the article to read. Leave it empty for the latest. 'List an article's versions' lists the version numbers.From 1 to 1000.

Outputs

author_nameslist
The authors' names, in order.
authorslist
The authors, in the order they are credited.
categorieslist
The research categories it is filed under.
citationtext
A ready-made citation, with the DOI link.
created_datetext
When this version was created, as an ISO 8601 UTC time.
custom_fieldslist
Extra details the publishing institution asks its depositors for.
descriptiontext
The description as plain text, paragraphs and lists kept, ready for a message or a summarizing step.
description_htmltext
The description exactly as deposited, as HTML.
doitext
The DOI of this version.
doi_urltext
The DOI as a https://doi.org/ link.
download_all_urltext
One link that downloads every file of this version as a ZIP archive. Empty when it has no files or downloads are turned off.
download_disabledtrue/false
Whether the depositor turned downloads off.
embargo_datetext
When the embargo lifts, when there is one.
figshare_urltext
The article's page on figshare.com.
file_countnumber
How many files it has.
fileslist
Its files, with sizes and download links.
first_onlinetext
When the first version went online, as YYYY-MM-DD.
fundinglist
The grants and funders it credits.
group_idnumber
The group within an institution that published it.
idnumber
The article's Figshare number.
is_confidentialtrue/false
Whether its files are kept confidential.
is_embargoedtrue/false
Whether its files are under embargo and not public yet.
is_metadata_recordtrue/false
Whether this is a description of data held elsewhere, with no files here.
item_typetext
What kind of item it is: dataset, figure, journal contribution...
item_type_idnumber
Figshare's number for that kind of item.
license_nametext
The licence it is published under, such as CC BY 4.0.
license_urltext
A link to that licence's terms.
matched_bytext
How the article was found from what was given: id, doi or link.
modified_datetext
When it last changed, as an ISO 8601 UTC time.
published_datetext
When this version was published, as an ISO 8601 UTC time.
referenceslist
Links to works it references or supplements.
related_materialslist
Related papers, datasets and other works, with how each relates.
resource_doitext
That paper's DOI, when given.
resource_titletext
The title of the paper this item supports, when given.
tagslist
The keywords its authors gave it.
thumbnail_urltext
A small preview image, when Figshare made one.
titletext
The title as plain text, on one line.
title_htmltext
The title exactly as deposited, HTML and all.
total_sizetext
That size for a person to read, such as 5.1 GB.
total_size_bytesnumber
The size of all its files together, in bytes.
urltext
The article's public page, on figshare.com or on the institution's own Figshare portal.
versionnumber
Which version this is. Versions count up from 1.
Example output
{
  "author_names": [
    "Robert Zomer",
    "Antonio Trabucco"
  ],
  "authors": [
    {
      "figshare_author_id": 12796235,
      "name": "Robert Zomer",
      "orcid_id": "0000-0002-2259-3359"
    },
    {
      "figshare_author_id": 6114969,
      "name": "Antonio Trabucco",
      "orcid_id": null
    }
  ],
  "categories": [
    "Climatology",
    "Hydrology not elsewhere classified",
    "Ecological impacts of climate change and ecological adaptation"
  ],
  "citation": "Zomer, Robert; Trabucco, Antonio (2019). Global Aridity Index and Potential Evapotranspiration (ET0) Database: Version 3.1. figshare. Dataset. https://doi.org/10.6084/m9.figshare.7504448.v7",
  "created_date": "2025-07-17T04:59:19Z",
  "custom_fields": [],
  "description": "Note: Version 3.1 supersedes all previous releases. Version 3.0 has been deprecated due to the discovery of a data inconsistency in the calculation of net longwave radiation in the source code used to generate the dataset.",
  "description_html": "<p dir=\"ltr\"><b>Note: </b>Version 3.1 supersedes all previous releases. Version 3.0 has been deprecated due to the discovery of a data inconsistency in the calculation of net longwave radiation in the source code used to generate the dataset.</p>",
  "doi": "10.6084/m9.figshare.7504448.v7",
  "doi_url": "https://doi.org/10.6084/m9.figshare.7504448.v7",
  "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/7/download",
  "download_disabled": false,
  "embargo_date": null,
  "figshare_url": "https://figshare.com/articles/dataset/Global_Aridity_Index_and_Potential_Evapotranspiration_ET0_Climate_Database_v2/7504448",
  "file_count": 5,
  "files": [
    {
      "download_url": "https://ndownloader.figshare.com/files/13901336",
      "extension": "jpg",
      "id": 13901336,
      "is_link_only": false,
      "md5": "a8bae19ff2807abc4042619cff124991",
      "mimetype": "image/jpeg",
      "name": "GlobalPET.jpg",
      "size": "266.4 KB",
      "size_bytes": 272830
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300216",
      "extension": "docx",
      "id": 56300216,
      "is_link_only": false,
      "md5": "ad026eba14bd5f50c6be2abc603ed74f",
      "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "name": "Global AI_ET0 v3.1 - Readme.docx",
      "size": "630.8 KB",
      "size_bytes": 645897
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300321",
      "extension": "zip",
      "id": 56300321,
      "is_link_only": false,
      "md5": "38d2f0d81e56cedf04d77a13ef0e49b1",
      "mimetype": "application/zip",
      "name": "Global-ET0__monthly_v3_1.zip",
      "size": "904.0 MB",
      "size_bytes": 947944955
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300327",
      "extension": "zip",
      "id": 56300327,
      "is_link_only": false,
      "md5": "ef3f6f53a082fb07365954b468cca55f",
      "mimetype": "application/zip",
      "name": "Global-AI_ET0__annual_v3_1.zip",
      "size": "615.9 MB",
      "size_bytes": 645783906
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56318348",
      "extension": "zip",
      "id": 56318348,
      "is_link_only": false,
      "md5": "d00fc98f5289c61654de312999d38091",
      "mimetype": "application/zip",
      "name": "Global_AI__monthly_v3_1.zip",
      "size": "3.6 GB",
      "size_bytes": 3861768106
    }
  ],
  "first_online": "2019-01-18",
  "funding": [
    "NSFC-CGIAR Project (Grant No. 31861143002)",
    "European Union - Horizon 2020 Research and Innovation Programme (Grant Agreement No: 101003881 NEXOGENESIS)"
  ],
  "group_id": null,
  "id": 7504448,
  "is_confidential": false,
  "is_embargoed": false,
  "is_metadata_record": false,
  "item_type": "dataset",
  "item_type_id": 3,
  "license_name": "CC BY 4.0",
  "license_url": "https://creativecommons.org/licenses/by/4.0/",
  "matched_by": "doi",
  "modified_date": "2025-07-17T04:59:20Z",
  "published_date": "2025-07-17T04:59:19Z",
  "references": [
    "https://www.nature.com/articles/s41597-022-01493-1"
  ],
  "related_materials": [
    {
      "identifier": "https://www.nature.com/articles/s41597-022-01493-1",
      "identifier_type": "URL",
      "link": "https://www.nature.com/articles/s41597-022-01493-1",
      "relation": "References",
      "title": null
    }
  ],
  "resource_doi": null,
  "resource_title": null,
  "tags": [
    "aridity index",
    "evapotranspiration",
    "geospatial modeling"
  ],
  "thumbnail_url": "https://s3-eu-west-1.amazonaws.com/pfigshare-u-previews/56300216/thumb.png",
  "title": "Global Aridity Index and Potential Evapotranspiration (ET0) Database: Version 3.1",
  "title_html": "Global Aridity Index and Potential Evapotranspiration (ET0) Database: Version 3.1",
  "total_size": "5.1 GB",
  "total_size_bytes": 5456415694,
  "url": "https://figshare.com/articles/dataset/Global_Aridity_Index_and_Potential_Evapotranspiration_ET0_Climate_Database_v2/7504448",
  "version": 7
}

Get an article file

Read one file of a Figshare item: its name, type, size, MD5 checksum and direct download link. Use it to fetch a known file again, or to check a file before downloading it.

Inputs

ArticlearticletextRequired
Which article: its Figshare number, its DOI, or the link to its page on figshare.com or an institution's Figshare portal. 'Search articles' returns the number.
Filefile_idtextRequired
The file's Figshare number, or its download link. 'List an article's files' returns both.

Outputs

article_idnumber
The article the file belongs to.
download_urltext
A direct download link that needs no account. Large files can be gigabytes, so check the size before fetching one in a workflow.
extensiontext
The file extension in lower case, such as csv or zip.
idnumber
The file's Figshare number. 'Get an article file' takes it.
is_link_onlytrue/false
Whether this is a link to a file held somewhere else rather than a file stored on Figshare.
md5text
The MD5 checksum, to check a download arrived whole.
mimetypetext
The file's media type, when Figshare knows it.
nametext
The file name.
sizetext
The size for a person to read, such as 3.6 GB.
size_bytesnumber
The size in bytes.
Example output
{
  "article_id": 7504448,
  "download_url": "https://ndownloader.figshare.com/files/13901336",
  "extension": "jpg",
  "id": 13901336,
  "is_link_only": false,
  "md5": "a8bae19ff2807abc4042619cff124991",
  "mimetype": "image/jpeg",
  "name": "GlobalPET.jpg",
  "size": "266.4 KB",
  "size_bytes": 272830
}

List a collection's articles

List the public items in a Figshare collection, each with its number, title, kind, DOI and page link, ready for 'Get an article' or 'List an article's files'.

Inputs

CollectioncollectiontextRequired
Which collection: its Figshare number, its DOI, or the link to its page. 'Search collections' returns the number.
How many per pagepage_sizenumber
How many to return in one go, up to 1,000. 20 if left empty. Figshare reaches the first 10,000 results at most, so narrow a search rather than paging deep into it.From 1 to 1000. Default: 20.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

articleslist
The articles in it.
collection_idnumber
The collection's Figshare number.
countnumber
How many came back on this page.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
Example output
{
  "articles": [
    {
      "created_date": "2020-03-02T10:40:07Z",
      "doi": "10.6084/m9.figshare.11317703.v1",
      "doi_url": "https://doi.org/10.6084/m9.figshare.11317703.v1",
      "group_id": 2826,
      "id": 11317703,
      "item_type": "dataset",
      "item_type_id": 3,
      "modified_date": "2024-02-16T09:14:14Z",
      "project_id": null,
      "published_date": "2020-03-02T10:40:07Z",
      "resource_doi": "10.1038/s41597-020-0421-y",
      "resource_title": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100",
      "thumbnail_url": null,
      "title": "Population Grid for China SSP4RCP8.5",
      "url": "https://springernature.figshare.com/articles/dataset/Population_Grid_for_China_SSP4RCP8_5/11317703"
    }
  ],
  "collection_id": 4605713,
  "count": 1,
  "more_available": true,
  "next_page": 2,
  "page": 1,
  "page_size": 1
}

List a collection's versions

List every public version of a Figshare collection, oldest first, with the latest version's number, so a workflow can notice when a collection has been updated.

Inputs

CollectioncollectiontextRequired
Which collection: its Figshare number, its DOI, or the link to its page. 'Search collections' returns the number.

Outputs

collection_idnumber
The collection's Figshare number.
countnumber
How many versions there are.
latest_versionnumber
The newest version's number.
versionslist
Every public version, oldest first.
Example output
{
  "collection_id": 4605713,
  "count": 1,
  "latest_version": 1,
  "versions": [
    {
      "funding": [],
      "version": 1
    }
  ]
}

List a project's articles

List the public items in a Figshare project, each with its number, title, kind, DOI and page link, ready for 'Get an article'.

Inputs

ProjectprojecttextRequired
Which project: its Figshare number or the link to its page. Projects have no DOI. 'Search projects' returns the number.
How many per pagepage_sizenumber
How many to return in one go, up to 1,000. 20 if left empty. Figshare reaches the first 10,000 results at most, so narrow a search rather than paging deep into it.From 1 to 1000. Default: 20.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

articleslist
The public articles in it.
countnumber
How many came back on this page.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
project_idnumber
The project's Figshare number.
Example output
{
  "articles": [
    {
      "created_date": "2024-08-22T19:51:35Z",
      "doi": "10.1184/R1/7890488.v6",
      "doi_url": "https://doi.org/10.1184/R1/7890488.v6",
      "group_id": 9882,
      "id": 7890488,
      "item_type": "dataset",
      "item_type_id": 3,
      "modified_date": "2024-08-22T19:51:35Z",
      "project_id": null,
      "published_date": "2024-08-22T19:51:35Z",
      "resource_doi": null,
      "resource_title": null,
      "thumbnail_url": null,
      "title": "Compiled historical daily temperature and precipitation data for selected 210 U.S. cities",
      "url": "https://kilthub.cmu.edu/articles/dataset/Compiled_daily_temperature_and_precipitation_data_for_the_U_S_cities/7890488"
    }
  ],
  "count": 1,
  "more_available": false,
  "next_page": null,
  "page": 1,
  "page_size": 20,
  "project_id": 61538
}

List an article's files

List the files of a Figshare item, at its latest version or an earlier one, each with its name, type, size, checksum and a direct download link that needs no account. The total size comes back too, so a workflow can check how big a download is before fetching it.

Inputs

ArticlearticletextRequired
Which article: its Figshare number, its DOI, or the link to its page on figshare.com or an institution's Figshare portal. 'Search articles' returns the number.
Versionversionnumber
Which version of the article to read. Leave it empty for the latest. 'List an article's versions' lists the version numbers.From 1 to 1000.
How many per pagepage_sizenumber
How many files to return in one go, up to 1,000. 100 if left empty, which is every file of almost any item.From 1 to 1000. Default: 100.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

article_idnumber
The article's Figshare number.
countnumber
How many came back on this page.
fileslist
The files, with sizes and download links.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
total_sizetext
That size for a person to read.
total_size_bytesnumber
The size of the files on this page, in bytes.
versionnumber
The version whose files these are, when one was asked for.
Example output
{
  "article_id": 7504448,
  "count": 5,
  "files": [
    {
      "download_url": "https://ndownloader.figshare.com/files/13901336",
      "extension": "jpg",
      "id": 13901336,
      "is_link_only": false,
      "md5": "a8bae19ff2807abc4042619cff124991",
      "mimetype": "image/jpeg",
      "name": "GlobalPET.jpg",
      "size": "266.4 KB",
      "size_bytes": 272830
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300216",
      "extension": "docx",
      "id": 56300216,
      "is_link_only": false,
      "md5": "ad026eba14bd5f50c6be2abc603ed74f",
      "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "name": "Global AI_ET0 v3.1 - Readme.docx",
      "size": "630.8 KB",
      "size_bytes": 645897
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300321",
      "extension": "zip",
      "id": 56300321,
      "is_link_only": false,
      "md5": "38d2f0d81e56cedf04d77a13ef0e49b1",
      "mimetype": "application/zip",
      "name": "Global-ET0__monthly_v3_1.zip",
      "size": "904.0 MB",
      "size_bytes": 947944955
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56300327",
      "extension": "zip",
      "id": 56300327,
      "is_link_only": false,
      "md5": "ef3f6f53a082fb07365954b468cca55f",
      "mimetype": "application/zip",
      "name": "Global-AI_ET0__annual_v3_1.zip",
      "size": "615.9 MB",
      "size_bytes": 645783906
    },
    {
      "download_url": "https://ndownloader.figshare.com/files/56318348",
      "extension": "zip",
      "id": 56318348,
      "is_link_only": false,
      "md5": "d00fc98f5289c61654de312999d38091",
      "mimetype": "application/zip",
      "name": "Global_AI__monthly_v3_1.zip",
      "size": "3.6 GB",
      "size_bytes": 3861768106
    }
  ],
  "more_available": false,
  "next_page": null,
  "page": 1,
  "page_size": 100,
  "total_size": "5.1 GB",
  "total_size_bytes": 5456415694,
  "version": null
}

List an article's versions

List every public version of a Figshare item, oldest first, with the latest version's number and a link that downloads each version's files as one archive. A workflow can compare the latest number with the one it saw last time to notice that an item has been updated.

Inputs

ArticlearticletextRequired
Which article: its Figshare number, its DOI, or the link to its page on figshare.com or an institution's Figshare portal. 'Search articles' returns the number.

Outputs

article_idnumber
The article's Figshare number.
countnumber
How many versions there are.
latest_versionnumber
The newest version's number.
versionslist
Every public version, oldest first.
Example output
{
  "article_id": 7504448,
  "count": 7,
  "latest_version": 7,
  "versions": [
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/1/download",
      "version": 1
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/2/download",
      "version": 2
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/3/download",
      "version": 3
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/4/download",
      "version": 4
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/5/download",
      "version": 5
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/6/download",
      "version": 6
    },
    {
      "download_all_url": "https://api.figshare.com/v2/articles/7504448/versions/7/download",
      "version": 7
    }
  ]
}

List categories

List the research categories Figshare files items under, from the Fields of Research classification, each with the broader category it belongs to and its code. Narrow it by a word to find the exact name the category filter on the searches takes.

Inputs

Name containsname_containstext
Only categories whose name, or whose broader category's name, contains this. Leave it empty for all of them, over two thousand.

Outputs

categorieslist
The categories, alphabetically.
countnumber
How many came back.
Example output
{
  "categories": [
    {
      "code": "410101",
      "has_subcategories": false,
      "id": 26869,
      "parent_id": 26866,
      "parent_title": "Climate change impacts and adaptation",
      "title": "Carbon sequestration science"
    },
    {
      "code": "4101",
      "has_subcategories": true,
      "id": 26866,
      "parent_id": 26863,
      "parent_title": null,
      "title": "Climate change impacts and adaptation"
    },
    {
      "code": "370202",
      "has_subcategories": false,
      "id": 25759,
      "parent_id": 25753,
      "parent_title": "Climate change science",
      "title": "Climatology"
    }
  ],
  "count": 3
}

List item types

List the kinds of item figshare.com accepts, such as dataset, figure and thesis, with what Figshare says each is for and the value the item type filter on 'Search articles' takes.

Inputs

None.

Outputs

countnumber
How many there are.
item_typeslist
The kinds of item figshare.com accepts.
Example output
{
  "count": 2,
  "item_types": [
    {
      "description": "Datasets usually provide raw data for analysis. This raw data often comes in spreadsheet form, but can be any collection of data, on which analysis can be performed.",
      "filter_value": "dataset",
      "id": 3,
      "name": "dataset"
    },
    {
      "description": "Any type of content formally published in an academic journal, usually following a peer-review process.",
      "filter_value": "journal_contribution",
      "id": 6,
      "name": "journal contribution"
    }
  ]
}

List licences

List the licences public Figshare items are published under, such as CC BY 4.0 and CC0, each with a link to its terms.

Inputs

None.

Outputs

countnumber
How many there are.
licenseslist
The licences public items can be published under.
Example output
{
  "count": 3,
  "licenses": [
    {
      "id": 1,
      "name": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    {
      "id": 3,
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    },
    {
      "id": 2,
      "name": "CC0",
      "url": "https://creativecommons.org/publicdomain/zero/1.0/"
    }
  ]
}

Search articles

Find public research on Figshare: datasets, figures, papers, posters, code, theses and more. Search by words, research category, kind of item, institution, group and the date it was published or changed, sorted by date, views, downloads or citations. Each result comes back with its number, title as plain text, DOI and page link, ready for 'Get an article'. Searching from a date is how a scheduled workflow picks up new research as it appears.

Inputs

Search forquerytext
Words to look for anywhere in a item's title, description, keywords and authors. Figshare also matches related word forms. Put a phrase in double quotes, or limit a search to one field with :title:, :description: or :author:. Leave it empty to list the newest.
Categorycategorytext
Only items filed under this research category. Pick one from the list, which holds every category Figshare files new items under, or type the exact name of an older one such as Ecology. 'List categories' finds names.
Kind of itemitem_typetext
Only one kind of item, such as datasets or theses. Leave it empty for every kind.One of: dataset, figure, journal_contribution (Journal contribution), media (Media (video, audio, 3D)), poster, presentation, thesis, software, preprint, online_resource (Online resource), and 17 more.
Published on or afterpublished_sincedate
Only items published on or after this date. A scheduled workflow watching for new research uses this with the date of its last run.
Changed on or aftermodified_sincedate
Only items changed on or after this date, new versions included.
Institutioninstitutionnumber
Only items from one institution, by Figshare's number for it. 'Get a collection' shows a collection's institution number; for example 2 is Loughborough University and 5 is PLOS.At least 1.
Groupgroupnumber
Only items from one group within an institution, such as a department or a journal, by its number. Every result shows the group number it came from.At least 1.
Sort byordertext
What to sort by. Date published by default. Figshare has no relevance order, so sorting by views is the way to see the best-known items first.One of: published_date (Date published), modified_date (Date last changed), created_date (Date created), views, downloads, shares, cites (Citations). Default: published_date.
Directionorder_directiontext
Newest or highest first by default, so the most recent or most viewed come first.One of: desc (Newest or highest first), asc (Oldest or lowest first). Default: desc.
How many per pagepage_sizenumber
How many to return in one go, up to 1,000. 20 if left empty. Figshare reaches the first 10,000 results at most, so narrow a search rather than paging deep into it.From 1 to 1000. Default: 20.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

articleslist
The articles found, in the order asked for.
countnumber
How many came back on this page.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
search_stringtext
The search Figshare actually ran, with the category filter written in its own syntax. Empty when only filters were given.
Example output
{
  "articles": [
    {
      "created_date": "2025-07-17T04:59:19Z",
      "doi": "10.6084/m9.figshare.7504448.v7",
      "doi_url": "https://doi.org/10.6084/m9.figshare.7504448.v7",
      "group_id": null,
      "id": 7504448,
      "item_type": "dataset",
      "item_type_id": 3,
      "modified_date": "2025-07-17T04:59:20Z",
      "project_id": 58232,
      "published_date": "2025-07-17T04:59:19Z",
      "resource_doi": null,
      "resource_title": null,
      "thumbnail_url": "https://s3-eu-west-1.amazonaws.com/pfigshare-u-previews/56300216/thumb.png",
      "title": "Global Aridity Index and Potential Evapotranspiration (ET0) Database: Version 3.1",
      "url": "https://figshare.com/articles/dataset/Global_Aridity_Index_and_Potential_Evapotranspiration_ET0_Climate_Database_v2/7504448"
    },
    {
      "created_date": "2018-07-16T19:13:30Z",
      "doi": "10.6084/m9.figshare.6396959",
      "doi_url": "https://doi.org/10.6084/m9.figshare.6396959",
      "group_id": null,
      "id": 6396959,
      "item_type": "dataset",
      "item_type_id": 3,
      "modified_date": "2023-05-30T10:00:22Z",
      "project_id": null,
      "published_date": "2018-07-16T19:13:30Z",
      "resource_doi": null,
      "resource_title": null,
      "thumbnail_url": null,
      "title": "Present and future K\u00f6ppen-Geiger climate classification maps at 1-km resolution",
      "url": "https://figshare.com/articles/dataset/Present_and_future_K_ppen-Geiger_climate_classification_maps_at_1-km_resolution/6396959"
    }
  ],
  "count": 2,
  "more_available": true,
  "next_page": 2,
  "page": 1,
  "page_size": 2,
  "search_string": "climate"
}

Search collections

Find public Figshare collections: curated sets of items, such as all the data behind one paper or a journal's supplementary material. Search by words, research category, institution, group and date, sorted by date, views or citations. Each result comes back with its number, title and DOI, ready for 'Get a collection'.

Inputs

Search forquerytext
Words to look for anywhere in a collection's title, description, keywords and authors. Figshare also matches related word forms. Put a phrase in double quotes, or limit a search to one field with :title:, :description: or :author:. Leave it empty to list the newest.
Categorycategorytext
Only items filed under this research category. Pick one from the list, which holds every category Figshare files new items under, or type the exact name of an older one such as Ecology. 'List categories' finds names.
Published on or afterpublished_sincedate
Only collections published on or after this date. A scheduled workflow watching for new research uses this with the date of its last run.
Changed on or aftermodified_sincedate
Only collections changed on or after this date, new versions included.
Institutioninstitutionnumber
Only items from one institution, by Figshare's number for it. 'Get a collection' shows a collection's institution number; for example 2 is Loughborough University and 5 is PLOS.At least 1.
Groupgroupnumber
Only items from one group within an institution, such as a department or a journal, by its number. Every result shows the group number it came from.At least 1.
Sort byordertext
What to sort by. Date published by default. Figshare has no relevance order, so sorting by views is the way to see the best-known items first.One of: published_date (Date published), modified_date (Date last changed), created_date (Date created), views, shares, cites (Citations). Default: published_date.
Directionorder_directiontext
Newest or highest first by default, so the most recent or most viewed come first.One of: desc (Newest or highest first), asc (Oldest or lowest first). Default: desc.
How many per pagepage_sizenumber
How many to return in one go, up to 1,000. 20 if left empty. Figshare reaches the first 10,000 results at most, so narrow a search rather than paging deep into it.From 1 to 1000. Default: 20.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

collectionslist
The collections found, in the order asked for.
countnumber
How many came back on this page.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
search_stringtext
The search Figshare actually ran, with the category filter written in its own syntax. Empty when only filters were given.
Example output
{
  "collections": [
    {
      "doi": "10.6084/m9.figshare.c.4605713.v1",
      "doi_url": "https://doi.org/10.6084/m9.figshare.c.4605713.v1",
      "id": 4605713,
      "published_date": "2020-03-02T10:40:08Z",
      "title": "Provincial and gridded population projection for China under shared socioeconomic pathways from 2010 to 2100"
    },
    {
      "doi": "10.6084/m9.figshare.c.5136302.v2",
      "doi_url": "https://doi.org/10.6084/m9.figshare.c.5136302.v2",
      "id": 5136302,
      "published_date": "2020-11-02T19:00:57Z",
      "title": "County-level CO2 emissions and sequestration in China"
    }
  ],
  "count": 2,
  "more_available": true,
  "next_page": 2,
  "page": 1,
  "page_size": 2,
  "search_string": "climate"
}

Search projects

Find public Figshare projects: the shared spaces where a research group publishes the items from one piece of work. Search by words, institution, group and date, sorted by date or views. Each result comes back with its number and title, ready for 'Get a project'.

Inputs

Search forquerytext
Words to look for anywhere in a project's title, description, keywords and authors. Figshare also matches related word forms. Put a phrase in double quotes, or limit a search to one field with :title:, :description: or :author:. Leave it empty to list the newest.
Published on or afterpublished_sincedate
Only projects published on or after this date. A scheduled workflow watching for new research uses this with the date of its last run.
Changed on or aftermodified_sincedate
Only projects changed on or after this date, new versions included.
Institutioninstitutionnumber
Only items from one institution, by Figshare's number for it. 'Get a collection' shows a collection's institution number; for example 2 is Loughborough University and 5 is PLOS.At least 1.
Groupgroupnumber
Only items from one group within an institution, such as a department or a journal, by its number. Every result shows the group number it came from.At least 1.
Sort byordertext
What to sort by. Date published by default. Figshare has no relevance order, so sorting by views is the way to see the best-known items first.One of: published_date (Date published), modified_date (Date last changed), views. Default: published_date.
Directionorder_directiontext
Newest or highest first by default, so the most recent or most viewed come first.One of: desc (Newest or highest first), asc (Oldest or lowest first). Default: desc.
How many per pagepage_sizenumber
How many to return in one go, up to 1,000. 20 if left empty. Figshare reaches the first 10,000 results at most, so narrow a search rather than paging deep into it.From 1 to 1000. Default: 20.
Pagepagenumber
Which page of results, from 1. A result's next page field says which to ask for next.From 1 to 1000. Default: 1.

Outputs

countnumber
How many came back on this page.
more_availabletrue/false
Whether the page came back full, so the next page may hold more. Figshare does not say how many match in all.
next_pagenumber
The page number to ask for next, or empty when this is the last page (or the 10,000th result has been reached).
pagenumber
Which page this is, from 1.
page_sizenumber
How many were asked for per page.
projectslist
The projects found, in the order asked for.
Example output
{
  "count": 2,
  "more_available": true,
  "next_page": 2,
  "page": 1,
  "page_size": 2,
  "projects": [
    {
      "created_date": "2019-03-25T20:58:11Z",
      "id": 61538,
      "modified_date": "2024-08-21T21:56:17Z",
      "published_date": "2019-04-05T19:45:33Z",
      "title": "Use of historical data to assess regional climate change"
    },
    {
      "created_date": "2022-07-21T07:00:25Z",
      "id": 144039,
      "modified_date": "2022-08-04T00:55:31Z",
      "published_date": "2022-07-21T07:50:37Z",
      "title": "Climate change increases global risk to urban forests"
    }
  ]
}

On this page