Getting Your API Key

An API key lets you authenticate requests to the RescueTime API on your own behalf.

You can create multiple keys, label them by use, and revoke any of them at any time without affecting your account or other keys.

Creating a Key
1

Go to API Key Management

Open your API Key Management page. You can also reach it via Account Settings → API.

2

Create a new key

Click Create new API key. Give it a label that describes what you'll use it for: "Home dashboard" or "Zapier", for example. The label is just for your reference.

3

Copy your key

Copy the key and store it somewhere safe. Treat it like a password: anyone who has it can read your RescueTime data.

Keep your key private. Do not commit it to a public code repository or include it in client-side code that runs in the browser. If a key is ever exposed, revoke it immediately and create a new one.


Using Your Key

Recommended: Bearer token in the Authorization header

Send your key as a Bearer token in the Authorization header. This keeps it out of URLs, browser history, and server logs.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://www.rescuetime.com/anapi/daily_summary_feed
	

Also accepted: key as a query parameter

You can also pass your key as a key query parameter. This works but is not recommended for new integrations: query parameters can end up in logs and browser history.

https://www.rescuetime.com/anapi/daily_summary_feed?key=YOUR_API_KEY
	

💡 Both APIs, one key. The same API key works for both the Analytic Data API and the Resource API. You do not need separate keys for each.


Revoking a Key

Go to your API Key Management page, find the key you want to remove, and click Revoke. The key stops working immediately. Any integration using that key will need to be updated with a new one.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us