Skip to main content
POST
/
authorize
Get an API key with an email (no dashboard, no prior signup)
curl --request POST \
  --url https://api.juicer.io/v1/authorize \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "ai-dev@example.com",
  "client_name": "Acme CLI"
}
'
{
  "status": "issued",
  "api_key": "jcr_9f...ab",
  "expires_at": "2023-11-07T05:31:56Z",
  "email_confirmation_required": true,
  "rate_limit": {
    "requests_per_hour": 60,
    "burst_per_minute": null
  },
  "upgrade_hint": "Confirm your email to raise your rate limit to 300 requests/hour and extend this key to 12 hours.",
  "upgrade_url": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.juicer.io/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
email
string<email>
required
Example:

"ai-dev@example.com"

​
client_name
string

Optional free-text name of the calling application. Shown verbatim on the authorization page for Mode B (for example "Acme CLI" or "My Feed Tool"). If omitted, the page uses a generic fallback.

Example:

"Acme CLI"

Response

Mode A — temporary API key issued immediately. Valid for 2 hours pre-confirmation; extended to 12 hours once the user confirms their email. expires_at is always present.

​
status
string
Example:

"issued"

​
api_key
string
Example:

"jcr_9f...ab"

​
expires_at
string<date-time>
​
email_confirmation_required
boolean
Example:

true

​
rate_limit
object

The rate limit tier applied to this pre-confirmation key

​
upgrade_hint
string
Example:

"Confirm your email to raise your rate limit to 300 requests/hour and extend this key to 12 hours."

​
upgrade_url
string<uri>

Link to the plans page where the user can upgrade