# Retrieving cited-by data using Crossref API **URL:** \ **Category:** Metadata Retrieval\ **Tags:** cited-by\ **Created:** [22 June 2021 03:33 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818 "2021-06-22T03:33:50Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![xdeng](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/xdeng/32/379_2.png) [@xdeng](https://community.crossref.org/u/xdeng)\ **Post date:** [22 June 2021 03:33 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818/1 "2021-06-22T03:33:50Z")
Hi, As a funding agency, our organization is interested to know how are our funded publications being cited over the years. I am aware of the XML query tool, but it seems that is only limited to self-managed DOIs. Is there a similar public tool that returns cited-by information from any DOI? Thanks in advance, Xiaojun ---
**Author:** ![pdavis](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/pdavis/32/981_2.png) [@pdavis](https://community.crossref.org/u/pdavis)\ **Post date:** [22 June 2021 15:29 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818/2 "2021-06-22T15:29:24Z")
Hello Xiaojun, You can return the cited by count against a DOI using the REST API. You can also search and return the counts from multiple DOIs using the REST API using the correct queries. Do you have an example DOI you would like to get the counts from? Or maybe a journal you would like the counts from? Feel free to send more information over, either here or to [support@crossref.org](mailto:support@crossref.org) and we can give more advice on retrieving the counts. If the DOIs are registered against your prefix then you can retrieve the works results too: [Retrieve citations using Cited-by - Crossref](https://www.crossref.org/documentation/cited-by/retrieve-citations/) Thanks, Paul ---
**Author:** ![xdeng](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/xdeng/32/379_2.png) [@xdeng](https://community.crossref.org/u/xdeng)\ **Post date:** [23 June 2021 03:44 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818/3 "2021-06-23T03:44:10Z")
Hi @pdavis, Thank you very much for your reply. It’s good to know that REST API provides powerful features. I have read through the [documentation on GitHub](https://github.com/CrossRef/rest-api-doc#resource-components) but was not able to find the answer. Would appreciate it very much if you could show me how to retrieve the counts. Here’s an example DOI we are interested in: [10.1002/joc.4081](https://doi.org/10.1002/joc.4081) In addition to citation counts, is there a way we can query the `/works` endpoint to retrieve details of each citing work? For example, it would be useful to know how the cited-by counts evolve on an annual basis. Thanks again for your reply! Best regards, Xiaojun ---
**Author:** ![pdavis](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/pdavis/32/981_2.png) [@pdavis](https://community.crossref.org/u/pdavis)\ **Post date:** [25 June 2021 12:59 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818/4 "2021-06-25T12:59:44Z")
Hello Xiaojun, So you can find the cited by counts in the API against the DOI querying just the DOI like here: [http://api.crossref.org/works/10.1002/joc.4081](http://api.crossref.org/works/10.1002/joc.4081). You would need to look for the **is-referenced-by-count:** value. Let me know if you want examples of querying for this data by journal or perhaps a prefix basis. You can’t query the REST API and get the citing works, that would be done via one of the methods from the link I sent in my first reply. To get the citation counts based on an annual basis you would need to query the DOIs each year and make a note of the numbers, then query them the next year and compare the results. There is no way of retrieving when the matches were made and when I am afraid. I hope this helps. Best regards, Paul ---
**Author:** ![xdeng](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/xdeng/32/379_2.png) [@xdeng](https://community.crossref.org/u/xdeng)\ **Post date:** [28 June 2021 00:22 UTC](https://community.crossref.org/t/retrieving-cited-by-data-using-crossref-api/1818/5 "2021-06-28T00:22:02Z")
Hi Paul, `is-reference-by-count` is really useful. Querying DOI counts each year sounds interesting. That should be sufficient for our purpose. Thank you for your information! Best regards, Xiaojun