/openalex/works

curl --request POST \
  --url https://api.anysite.io/api/openalex/works \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "work": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@openalex_work",
    "doi": "<string>",
    "title": "",
    "publication_year": 123,
    "publication_date": "<string>",
    "language": "<string>",
    "type": "<string>",
    "pmid": "<string>",
    "mag_id": "<string>",
    "cited_by_count": 0,
    "fwci": 123,
    "referenced_works_count": 0,
    "is_retracted": false,
    "is_oa": true,
    "oa_status": "<string>",
    "oa_url": "<string>",
    "indexed_in": [],
    "citation_normalized_percentile": {
      "@type": "@openalex_citation_percentile",
      "value": 123,
      "is_in_top_1_percent": true,
      "is_in_top_10_percent": true
    },
    "abstract": "<string>",
    "primary_location": {
      "@type": "@openalex_work_location",
      "is_oa": true,
      "landing_page_url": "<string>",
      "pdf_url": "<string>",
      "license": "<string>",
      "version": "<string>",
      "source": {
        "@type": "@openalex_work_source",
        "id": "<string>",
        "display_name": "<string>",
        "issn_l": "<string>",
        "type": "<string>",
        "is_oa": true,
        "is_in_doaj": true,
        "host_organization_name": "<string>"
      }
    },
    "best_oa_location": {
      "@type": "@openalex_work_location",
      "is_oa": true,
      "landing_page_url": "<string>",
      "pdf_url": "<string>",
      "license": "<string>",
      "version": "<string>",
      "source": {
        "@type": "@openalex_work_source",
        "id": "<string>",
        "display_name": "<string>",
        "issn_l": "<string>",
        "type": "<string>",
        "is_oa": true,
        "is_in_doaj": true,
        "host_organization_name": "<string>"
      }
    },
    "biblio": {
      "@type": "@openalex_biblio",
      "volume": "<string>",
      "issue": "<string>",
      "first_page": "<string>",
      "last_page": "<string>"
    },
    "primary_topic": {
      "id": "<string>",
      "@type": "@openalex_topic",
      "display_name": "",
      "score": 123,
      "works_count": 123,
      "topic_share": 123,
      "subfield": "<string>",
      "field": "<string>",
      "domain": "<string>"
    },
    "authorships": [],
    "corresponding_author_ids": [],
    "topics": [],
    "keywords": [],
    "concepts": [],
    "mesh": [],
    "funders": [],
    "sustainable_development_goals": [],
    "referenced_works": [],
    "related_works": [],
    "counts_by_year": []
  }
]

/openalex

/openalex/works

Get an OpenAlex work (paper) by its identifier **Price:** 1 credit **💡 AI Hint:** Get full details of an academic work (paper, book chapter, dataset, etc.) from OpenAlex by its identifier. Accepts an OpenAlex work id (W...), a DOI URL, or a prefixed id like doi:<doi>, pmid:<id>, mag:<id>. Returns title, DOI, publication year and date, language, work type, open-access status and PDF/landing links, the reconstructed abstract, authors with their institutions and countries, corresponding-author ids, the primary and best open-access publication venues, bibliographic info (volume, issue, pages), primary and secondary research topics, keywords, concepts, MeSH medical-subject headings, funders with award ids, sustainable-development-goal tags, the sources the work is indexed in, citation count, field-weighted citation impact and its normalized percentile, referenced and related works, and year-by-year citation counts. **⚠️ Common errors:** 412: Work not found

POST

api

openalex

works

/openalex/works

curl --request POST \
  --url https://api.anysite.io/api/openalex/works \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "work": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@openalex_work",
    "doi": "<string>",
    "title": "",
    "publication_year": 123,
    "publication_date": "<string>",
    "language": "<string>",
    "type": "<string>",
    "pmid": "<string>",
    "mag_id": "<string>",
    "cited_by_count": 0,
    "fwci": 123,
    "referenced_works_count": 0,
    "is_retracted": false,
    "is_oa": true,
    "oa_status": "<string>",
    "oa_url": "<string>",
    "indexed_in": [],
    "citation_normalized_percentile": {
      "@type": "@openalex_citation_percentile",
      "value": 123,
      "is_in_top_1_percent": true,
      "is_in_top_10_percent": true
    },
    "abstract": "<string>",
    "primary_location": {
      "@type": "@openalex_work_location",
      "is_oa": true,
      "landing_page_url": "<string>",
      "pdf_url": "<string>",
      "license": "<string>",
      "version": "<string>",
      "source": {
        "@type": "@openalex_work_source",
        "id": "<string>",
        "display_name": "<string>",
        "issn_l": "<string>",
        "type": "<string>",
        "is_oa": true,
        "is_in_doaj": true,
        "host_organization_name": "<string>"
      }
    },
    "best_oa_location": {
      "@type": "@openalex_work_location",
      "is_oa": true,
      "landing_page_url": "<string>",
      "pdf_url": "<string>",
      "license": "<string>",
      "version": "<string>",
      "source": {
        "@type": "@openalex_work_source",
        "id": "<string>",
        "display_name": "<string>",
        "issn_l": "<string>",
        "type": "<string>",
        "is_oa": true,
        "is_in_doaj": true,
        "host_organization_name": "<string>"
      }
    },
    "biblio": {
      "@type": "@openalex_biblio",
      "volume": "<string>",
      "issue": "<string>",
      "first_page": "<string>",
      "last_page": "<string>"
    },
    "primary_topic": {
      "id": "<string>",
      "@type": "@openalex_topic",
      "display_name": "",
      "score": 123,
      "works_count": 123,
      "topic_share": 123,
      "subfield": "<string>",
      "field": "<string>",
      "domain": "<string>"
    },
    "authorships": [],
    "corresponding_author_ids": [],
    "topics": [],
    "keywords": [],
    "concepts": [],
    "mesh": [],
    "funders": [],
    "sustainable_development_goals": [],
    "referenced_works": [],
    "related_works": [],
    "counts_by_year": []
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

work

string

required

Work identifier: OpenAlex id (W...), a DOI (bare or URL), or a prefixed id (pmid:, mag:)

Minimum string length: 1

Examples:

"W2741809807"

"10.7717/peerj.4375"

"https://doi.org/10.7717/peerj.4375"

"pmid:29456894"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

string

required

@type

string

default:@openalex_work

doi

string | null

title

string

default:""

publication_year

integer | null

publication_date

string | null

language

string | null

type

string | null

pmid

string | null

mag_id

string | null

cited_by_count

integer

default:0

fwci

number | null

referenced_works_count

integer

default:0

is_retracted

boolean

default:false

is_oa

boolean | null

oa_status

string | null

oa_url

string | null

indexed_in

string[]

citation_normalized_percentile

OpenalexCitationPercentile · object

Show child attributes

abstract

string | null

primary_location

OpenalexWorkLocation · object

Show child attributes

best_oa_location

OpenalexWorkLocation · object

Show child attributes

biblio

OpenalexBiblio · object

Show child attributes

primary_topic

OpenalexTopic · object

Show child attributes

authorships

OpenalexAuthorship · object[]

Show child attributes

corresponding_author_ids

string[]

topics

OpenalexTopic · object[]

Show child attributes

keywords

OpenalexKeyword · object[]

Show child attributes

concepts

OpenalexConcept · object[]

Show child attributes

mesh

OpenalexMeshTerm · object[]

Show child attributes

funders

OpenalexFunder · object[]

Show child attributes

sustainable_development_goals

OpenalexSdg · object[]

Show child attributes

referenced_works

string[]

counts_by_year

OpenalexCountByYear · object[]

Show child attributes

/openalex/topics/search /openalex/works/citations