API keys
Signed-in users can create API keys from the GitStars.io user menu under API keys.
Limits
Section titled “Limits”Each account can have up to five active API keys. Revoke an existing key before creating another one.
Usage view
Section titled “Usage view”The API keys page shows usage per active key:
- total requests, errors, blocked calls, transfer, and recent IP count
- top endpoints for the selected period
- observed rate-limit pressure, based on the lowest remaining request count seen for that key
- recent errors and rate-limit blocks
- recent IPs and user-agent families
Use the period selector to switch between the last 24 hours, 7 days, 30 days, and 90 days.
Key handling
Section titled “Key handling”GitStars.io shows the full key only once, immediately after creation. Store it in your client secret manager. If the value is lost, revoke the key and create a replacement.
Request headers
Section titled “Request headers”Send the key with Authorization: Bearer:
curl -H "Authorization: Bearer YOUR_API_KEY" "https://gitstars.io/api/repos?q=react"You can also use X-API-Key:
curl -H "X-API-Key: YOUR_API_KEY" "https://gitstars.io/api/trending?window=24h"API keys are optional for public endpoints. Requests without a key still work with anonymous rate limits.