CitedEvidenceResearch APIs

Filter grammar

Compatibility filters for every list endpoint.

Filters are comma-separated predicates passed in the filter= query parameter. Multiple filters are AND-ed; use | within a value to OR.

Operators

  • GETfilter=key:value

    Equality.

  • GETfilter=key:!value

    Negation.

  • GETfilter=key:>value

    Greater-than. Also >=, <, <=.

  • GETfilter=key:start-end

    Inclusive range.

  • GETfilter=key:v1|v2|v3

    OR across values.

  • GETfilter=key.sub:value

    Dotted keys descend into nested fields (authorships.institutions.country_code, …).

Popular filters

  • GET/v1/oa/works?filter=publication_year:2020-2024

    Range on publication year.

  • GET/v1/oa/works?filter=author.orcid:0000-0002-1825-0097

    Works by an author by ORCID.

  • GET/v1/oa/works?filter=cited_by_count:>100,open_access.is_oa:true

    Highly-cited OA works.

  • GET/v1/oa/works?filter=concepts.id:C17744445

    Works tagged with concept.

  • GET/v1/oa/works?filter=authorships.institutions.country_code:us|ca

    US or Canadian affiliation.