Skip to main content
Your API key is required to authenticate all requests to the Shovels API.

​
Accessing Your API Key

  1. Log into your Shovels account
  2. Navigate to the Profile Settings section
  3. Your API key is displayed in the API Key field

​
Using Your API Key

Include your API key in the header of every API request: 
curl -X GET "https://api.shovels.ai/v2/meta/release" \
  -H "X-API-Key: YOUR_API_KEY_HERE"

​
Free Trial API Access

New accounts receive 250 free requests to explore our capabilities before committing to a paid plan.
During the free trial, each API call counts as 1 request, regardless of how many records are returned. Paid plans use a credit-based system where each record returned counts against your credits.

​
Tracking Your Usage

You can view your API credit usage in the Profile Settings or by calling the GET /v2/usage endpoint. Credits operate on a 30-day rolling window.

​
Need More Credits?

If you hit your limit and need more credits: