Working on fetchers

Fetchers are the implementation of the search using online services. Some fetchers require API keys to get them working. To get the fetchers running in a JabRef development setup, the keys need to be placed in the respective environment variable. The following table lists the respective fetchers, where to get the key from and the environment variable where the key has to be placed.


Key Source

Environment Variable

Rate Limit


IEEE Xplore API portal


200 calls/day




Depending on the current network

SAO/NASA Astrophysics Data System



5000 calls/day

Springer Nature

Springer Nature API Portal


5000 calls/day

Zentralblatt Math



Depending on the current network

"Depending on the current network" means that it depends whether your request is routed through a network having paid access. For instance, some universities have subscriptions to MathSciNet.

On Windows, you have to log-off and log-on to let IntelliJ know about the environment variable change. Execute the gradle task "processResources" in the group "others" within IntelliJ to ensure the values have been correctly written. Now, the fetcher tests should run without issues.

Background on embedding the keys in JabRef

The keys are placed into the file.


In build.gradle, these variables are filled:

"springerNatureAPIKey": System.getenv('SpringerNatureAPIKey')

The BuildInfo class reads from that file.

new BuildInfo().springerNatureAPIKey

When executing ./gradlew run, gradle executes processResources and populates build/ accordingly. However, when working directly in the IDE, Eclipse keeps reading from src/main/resources. In IntelliJ, the task JabRef Main is executing ./gradlew processResources before running JabRef from the IDE to ensure the is properly populated.

Edit on GitHub