Skip to main content
POST
/openalex/works/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
search
string | null
title_search
string | null
abstract_search
string | null
fulltext_search
string | null
publication_year
integer | null
from_publication_date
string | null
to_publication_date
string | null
type
enum<string> | null
Available options:
article,
book,
book-chapter,
dataset,
dissertation,
editorial,
erratum,
grant,
letter,
other,
paratext,
peer-review,
preprint,
reference-entry,
report,
retraction,
review,
standard,
supplementary-materials
is_oa
boolean | null
oa_status
enum<string> | null
Available options:
gold,
green,
hybrid,
bronze,
closed,
diamond
has_doi
boolean | null
has_abstract
boolean | null
has_fulltext
boolean | null
is_retracted
boolean | null
language
string | null
author_id
string | null
institution_id
string | null
institution_country_code
string | null
source_id
string | null
source_issn
string | null
publisher
string | null
funder_id
string | null
topic_id
string | null
primary_topic_id
string | null
concept_id
string | null
keyword_id
string | null
sdg_id
string | null
cited_by_count
string | null
cites
string | null
cited_by
string | null
sort
enum<string> | null
Available options:
relevance_score:desc,
cited_by_count:desc,
cited_by_count:asc,
publication_date:desc,
publication_date:asc

Response

Successful Response

id
string
required
@type
string
default:OpenalexWork
doi
string | null
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
object | null
abstract
string | null
primary_location
object | null
best_oa_location
object | null
biblio
object | null
primary_topic
object | null
authorships
object[]
corresponding_author_ids
string[]
topics
object[]
keywords
object[]
concepts
object[]
mesh
object[]
funders
object[]
sustainable_development_goals
object[]
referenced_works
string[]
counts_by_year
object[]