# TDM click-through service

**URL:** <https://community.crossref.org/t/tdm-click-through-service/1157>\
**Category:** Technical Support\
**Tags:** tdm\
**Created:** [24 October 2019 12:35 UTC](https://community.crossref.org/t/tdm-click-through-service/1157 "2019-10-24T12:35:06Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![dplavin](https://avatars.discourse-cdn.com/v4/letter/d/43a26b/32.png) [@dplavin](https://community.crossref.org/u/dplavin)\
**Post date:** [24 October 2019 12:35 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/1 "2019-10-24T12:35:06Z")

</div>

Hi there,

Caveat: Forgive me if I have missed the documentation about this on the Crossref site. Can you share how the click-through service works for TDM, and what would need to be done to enable this for publishers looking to leverage Crossref’s TDM feature?

Thank you!

---

<div class="post-metadata">

**Author:** ![ifarley](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/ifarley/32/44_2.png) [@ifarley](https://community.crossref.org/u/ifarley)\
**Post date:** [29 October 2019 18:10 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/2 "2019-10-29T18:10:51Z")

</div>

Hi @dplavin, welcome to the community forum! We are deprecating the click-through service because it was just not supported or used by the community.

This API query - [http://api.crossref.org/works?filter=has-license:true,has-full-text:true,license.version:tdm](http://api.crossref.org/works?filter=has-license:true,has-full-text:true,license.version:tdm) - will give you all the DOIs with a text and data mining license registered with us.

Please let me know if you have any additional questions.

Kind regards,  
Isaac

---

<div class="post-metadata">

**Author:** ![sckott](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/sckott/32/61_2.png) [@sckott](https://community.crossref.org/u/sckott)\
**Post date:** [30 October 2019 14:12 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/3 "2019-10-30T14:12:40Z")

</div>

> [@ifarley](#):
>
> We are deprecating the click-through service

Is there any further information on this? I do use the click through service in this R package [GitHub - ropensci-archive/crminer: ⛔ ARCHIVED Fetch 'Scholary' Full Text from 'Crossref'](https://github.com/ropensci/crminer) At least with respect to pointing users to [https://apps.crossref.org/clickthrough/researchers](https://apps.crossref.org/clickthrough/researchers) to get authenticated . In `crminer`, we then use the user’s authentication details from the click through page to fetch pdf/xml/etc. Is there anything to replace this aspect, allowing users to get full text with appropriate authentication?

---

<div class="post-metadata">

**Author:** ![ifarley](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/ifarley/32/44_2.png) [@ifarley](https://community.crossref.org/u/ifarley)\
**Post date:** [31 October 2019 19:01 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/4 "2019-10-31T19:01:31Z")

</div>

Hi @sckott. Thanks for your message. We haven’t defined a timeline for that deprecation yet, but, based on my understanding, click-through was only ever meant to be an interim solution until publishers included tdm in their regular licenses. Many are doing that now.

---

<div class="post-metadata">

**Author:** ![sckott](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/sckott/32/61_2.png) [@sckott](https://community.crossref.org/u/sckott)\
**Post date:** [31 October 2019 19:41 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/5 "2019-10-31T19:41:45Z")

</div>

> [@ifarley](#):
>
> until publishers included tdm in their regular licenses

what does _included tdm in their regular licenses_ that mean exactly?

Will there still be a way for users to request full text (pdf/xml) with some kind of Crossref API key? Or will that be on a publisher by publisher basis?

---

<div class="post-metadata">

**Author:** ![ifarley](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/ifarley/32/44_2.png) [@ifarley](https://community.crossref.org/u/ifarley)\
**Post date:** [4 November 2019 22:15 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/6 "2019-11-04T22:15:16Z")

</div>

Hi @sckott, once the click-through service is deprecated there will not be a Crossref API key to request full text. We won’t be retaining that role as an intermediary.

So, the way that will work for researchers is:

To use Crossref’s metadata services to perform TDM, researchers should have a list of DOIs for the content they want to download, and a whitelist of licenses that they accept. Researchers can get a list of DOIs from citations, our [metadata search](https://search.crossref.org/), our [metadata API](https://api.crossref.org/), or another source.

For each DOI, researchers should:

1. Use [content negotiation](https://eduprev.crossref.org/education/retrieve-metadata#looking-up-metadata-and-identifiers#content-negotiation) to get the metadata for the DOI
2. Check to see if the DOI has license and full-text details in its metadata
3. Check the license against your whitelist of acceptable licenses
4. If you agree to the license, follow the link and download the full-text of the content item.

Does that answer your question?

My best,  
Isaac

---

<div class="post-metadata">

**Author:** ![sckott](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/sckott/32/61_2.png) [@sckott](https://community.crossref.org/u/sckott)\
**Post date:** [4 November 2019 23:10 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/7 "2019-11-04T23:10:32Z")

</div>

Sure, that makes sense. Does _deprecated_ here mean gone, or in the software sense, where it’s no longer meant to be used, but is still useable for some time period? And when will it be completely gone/unavailable?

---

<div class="post-metadata">

**Author:** ![ifarley](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/ifarley/32/44_2.png) [@ifarley](https://community.crossref.org/u/ifarley)\
**Post date:** [5 November 2019 19:22 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/8 "2019-11-05T19:22:54Z")

</div>

I believe that means that the software is no longer meant to be used - that is we are no longer supporting it - but it will still be useable for a period of time. I don’t have a timetable, but let me see if I can get an estimate for you.

@Ginny do you know any more specifics about deprecating click-through?

---

<div class="post-metadata">

**Author:** ![Ginny](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/ginny/32/1694_2.png) [@Ginny](https://community.crossref.org/u/Ginny)\
**Post date:** [5 November 2019 21:32 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/9 "2019-11-05T21:32:44Z")

</div>

Hi @sckott - the _desire_ to deprecate it depends on a review scheduled for December. As part of that we should definitely chat to understand better how the rCrossref (or crminer?) package is using it. Only three publishers have ever set up this click-through so it doesn’t cover our full metadata anyway and in total over many years only 80 users have actually clicked through (last time we checked). It may be that it’s just not a necessary step for your tool and you can bypass this now. But we won’t make a decision until we review properly how it’s being used (for example those 80 ‘users’ could each be representing thousands of others). So this is very good to know. I’ll make sure the product team (Bryan Vickery is our new product director) is aware and we will reach out to you soon. Tagging @KirstyM in the meantime.

Hope you are well too!  
Ginny

---

<div class="post-metadata">

**Author:** ![sckott](https://sea2.discourse-cdn.com/flex020/user_avatar/community.crossref.org/sckott/32/61_2.png) [@sckott](https://community.crossref.org/u/sckott)\
**Post date:** [6 November 2019 18:04 UTC](https://community.crossref.org/t/tdm-click-through-service/1157/10 "2019-11-06T18:04:07Z")

</div>

Hi @Ginny Thanks for the detailed response. The click-through service is used in both [rcrossref](https://github.com/ropensci/rcrossref) and [crminer](https://github.com/ropensci/crminer) R packages; I don’t know what usage is like for TDM through these packages, but I imagine user agent strings could be examined to get a sense; we send user agents strings from those two packages that include the package name and the string `ropensci`.

A Ruby library ([textminer](https://github.com/sckott/textminer)) i maintain also uses the service, but usage of this library is probably low to non-existent.

All I’m looking for is 1) timing on when things will change, and 2) clear steps on how to allow users to fetch full text assuming they have access. For 2), @ifarley gave some [steps above](https://community.crossref.org/t/tdm-click-through-service/1157/6); however, links to full text in my experience are not always up to date, so that could be an issue
