Maximum value counts for facet queries in the REST API

We’ve modified the behaviour of facet queries to improve performance and match our documentation. Previously, if you made a request like:

https://api.crossref.org/v1/works?facet=publisher-name:*

you would get a list of all publisher names, whereas if you requested a specific number, e.g.:

https://api.crossref.org/v1/works?facet=publisher-name:3000

you would only get a maximum of 1000 values in the result. To be consistent and avoid ensure that queries can complete, we’ve modified the behaviour so that any request using a facet parameter will return a maximum of 1000 values.

If you’re interested in digging deeper, you can download and use our public data file (or use a monthly snapshot if you are a Metadata Plus subscriber).

1 Like