Harvard Dataverse
Harvard Dataverse is a research data repository hosted at Harvard University and open to researchers in any field, with many social science replication datasets. Through ScholarMuse, an agent searches its published datasets by keyword and gets the DOI or persistent ID, authors, publication date, the collection it sits in, subjects, file count and version.
ScholarMuse tools: search_datasets. Each successful call uses credits.
The web tool runs without an account, up to 5 runs a day per visitor.
Ask your agent
What your agent gets back
Every record carries id, source, title, url, license, attribution and retrievedAt. The fields below are the data that comes from Harvard Dataverse.
search_datasets
The Dataverse search API does not give the dataset licence, so license is empty unless another source in the same call returned the same DOI.
- doi
- Dataset DOI, lower case
- creators
- Creator names, up to 10
- year
- Publication year
- persistentId
- Global ID when it is not a DOI
- date
- Publication date (YYYY-MM-DD)
- collection
- Name of the dataverse collection
- description
- Dataset description, tags removed
- fileCount
- Number of files in the dataset
- subjects
- Subject categories, up to 6
- version
- Version as major.minor
- alsoIn
- Other sources that returned the same dataset
What it covers
- Published datasets in the Harvard Dataverse installation at dataverse.harvard.edu.
- Other Dataverse installations run by other institutions are not searched.
- Each record links to the dataset's page, where files and terms of use are shown.
Limits
- One call returns at most 25 datasets (default 10). When several repositories are searched together, that number is shared between them, so name Harvard Dataverse alone to fill it.
- The only search input is a keyword query. There are no year, licence, author or file-type filters; the agent has to read those fields in the results.
- The dataset's licence or terms, its size and its file names are not returned; check the dataset page before reuse.
- Only datasets are searched, not individual files or collections. An upstream request is abandoned after 30 seconds.
How ScholarMuse reaches Harvard Dataverse
The connector calls dataverse.harvard.edu/api/search with no API token, restricted to type dataset.
Responses are cached for up to 6 hours, so a dataset published at Harvard Dataverse in the last few hours may not appear yet.
API key: the upstream API can be called without one, so you do not add one.
Licence and attribution
Licence: CC0-1.0 (metadata)
Metadata from Harvard Dataverse (dataverse.harvard.edu). Each dataset carries its own licence or terms.
Records that come from Harvard Dataverse carry this licence and attribution. When you cite the data in a paper, follow Harvard Dataverse's own citation guidance.
