Skip to main content
All API endpoints (except /v1/health) require an API key passed in the X-API-Key header.

​
Getting a key

Sign up at gildea.ai to receive your API key. Keys are prefixed with gld_.

​
Using your key

Include the key in every request: 
curl -H "X-API-Key: gld_your_key_here" \
  "https://api.gildea.ai/v1/signals?keyword=test"

import requests

headers = {"X-API-Key": "gld_your_key_here"}
resp = requests.get("https://api.gildea.ai/v1/signals", headers=headers, params={"keyword": "test"})

const resp = await fetch("https://api.gildea.ai/v1/signals?keyword=test", {
  headers: { "X-API-Key": "gld_your_key_here" }
});

​
Tiers

Every tier has access to all endpoints, including hybrid search. Tiers differ only in request volume.
TierRate limitMonthly limit
Free20 req/min250/month
Pro60 req/min5,000/month
TeamCustomCustom (contact sales)

​
Error responses

An invalid, revoked, or expired API key returns 401: 
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "status": 401
  }
}
If the X-API-Key header is omitted entirely, the API returns 422 (missing required header). If the header is present but the key is invalid, the API returns 401.

​
Security

  • Keys are hashed with SHA-256 before storage; we never store plaintext keys
  • Need a key rotated or revoked? Contact us and we’ll revoke it immediately
  • All requests are logged for usage tracking