Authentication
Include your API key in every request using one of these methods:
# Option 1: Authorization header
curl -H "Authorization: Bearer gco_your_key_here" https://getcurrentoffer.com/api/v1/offers
# Option 2: X-API-Key header
curl -H "X-API-Key: gco_your_key_here" https://getcurrentoffer.com/api/v1/offersRate Limits
Rate limits reset daily at midnight UTC. Responses include rate limit headers.
| Tier | Daily Limit | Price |
|---|---|---|
| Free | 100 requests/day | $0 |
| Pro | 10,000 requests/day | $9/month |
| Enterprise | 100,000 requests/day | Custom |
Response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Endpoints
Code Examples
cURL
curl -s -H "X-API-Key: gco_your_key" \
"https://getcurrentoffer.com/api/v1/offers?q=nike&limit=5" | jq .JavaScript (fetch)
const response = await fetch('https://getcurrentoffer.com/api/v1/offers?q=nike&limit=5', {
headers: { 'X-API-Key': 'gco_your_key' }
});
const data = await response.json();
console.log(data.offers);Python (requests)
import requests
resp = requests.get(
'https://getcurrentoffer.com/api/v1/offers',
params={'q': 'nike', 'limit': 5},
headers={'X-API-Key': 'gco_your_key'}
)
data = resp.json()
for offer in data['offers']:
print(f"{offer['merchant']}: {offer['title']}")Try It
Error Codes
| Status | Description |
|---|---|
| 401 | Missing, invalid, or revoked API key |
| 404 | Resource not found |
| 429 | Rate limit exceeded (check Retry-After header) |
| 500 | Internal server error |