Peluka API

Programmatic access to eRepublik data. Build bots, dashboards, spreadsheets, or integrate game data into your own tools.

Getting Started

Base URL: https://api.peluka.info/erpk/v1

Authentication: API Key via X-API-Key header

Sign up for free to get your API key. Upgrade your plan for higher rate limits and access to premium endpoints.

Available Endpoints

Citizens

GET /citizen/{id} Get citizen profile
GET /citizen/{id}/stats Citizen statistics (MasterG)
GET /citizen/{id}/unified Merged profile from multiple sources
POST /citizen/search Search citizens by name
GET /citizen/registered/total Total registered citizens

Military

GET /military/unit/{id}/members Military unit members with stats
GET /military/campaigns Active military campaigns
GET /military/battle/{id} Battle details

Market

GET /market/item/best-offers Best item offers across countries
GET /market/monetary/gold Gold monetary market offers
GET /market/monetary/currency Currency monetary market offers

Rankings

GET /rankings/top-fighter Top fighters ranking
GET /rankings/top-aviator Top aviators ranking

Countries & Regions

GET /game/country/list List of all countries
GET /region/{regionId} Region details

Events

GET /events/articles Latest published articles
GET /events/military Military events feed

Quick Example

Fetch a citizen profile:

$ curl -H "X-API-Key: YOUR_KEY" \
https://api.peluka.info/erpk/v1/citizen/1

Rate Limits

Rate limits vary by subscription tier and API source. Response headers include:

X-Rate-Limit-Limit Maximum available calls per hour
X-Rate-Limit-Remaining Remaining calls in current window
X-Rate-Limit-Reset Timestamp when the limit resets

Exceeding the limit returns 429 Too Many Requests with a Retry-After header.

Ready to start?

Sign up for free or upgrade your plan for higher limits and premium endpoints.

Sign Up Free View Plans
eRepublik.tools eRepublik
Telegram
Peluka Stats Military Events Latest Articles
Discord
Powered by Peluka.info