Freecash APIfreecash.io ↗
Access Freecash.io public data via API: withdrawal feed, platform stats, top earner leaderboard, featured offers, offer categories, and cashout methods.
What is the Freecash API?
The Freecash API exposes 6 endpoints covering the platform's public activity data, including real-time withdrawal transactions, earnings leaderboard, and platform-wide statistics. The get_withdrawals endpoint returns individual transaction records with fields like username, coins, withdrawType, countryCode, and date. The get_leaderboard endpoint supports daily, weekly, and monthly period filters. Together the endpoints give a structured view of Freecash user activity and available earning opportunities.
curl -X GET 'https://api.parse.bot/scraper/70a7be56-cb0c-481c-a10b-dc8ae6d532d8/get_leaderboard' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace freecash-io-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Freecash SDK — bounded, re-runnable; every call capped."""
from parse_apis.Freecash_API import Freecash, CountryCode, NotFoundError
freecash = Freecash()
# Get platform-wide statistics (single resource, no pagination)
stats = freecash.stats.get()
print(stats.total_earnings, stats.average_earning_yesterday, stats.registered_users)
# List recent withdrawals filtered to US users
for withdrawal in freecash.withdrawals.list(country_code=CountryCode.US, limit=5):
print(withdrawal.username, withdrawal.coins, withdrawal.withdraw_type, withdrawal.date)
# Browse available cashout methods
for method in freecash.cashout_methods.list(limit=5):
print(method.name, method.type)
# List featured offers currently on the homepage
for offer in freecash.featured_offers.list(limit=5):
print(offer.name)
# List offer categories with typed error handling
try:
for category in freecash.offer_categories.list(limit=10):
print(category.id, category.name)
except NotFoundError as exc:
print(f"categories unavailable: {exc}")
print("exercised: stats.get / withdrawals.list / cashout_methods.list / featured_offers.list / offer_categories.list")
Retrieve the earnings leaderboard showing top earners on the platform.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| limit | integer | Max results per page. |
| period | string | Time period: DAILY, WEEKLY, MONTHLY. |
| source | string | Earning source, usually COINS. |
{
"type": "object",
"fields": {
"meta": "object",
"items": "array"
},
"sample": {
"meta": {
"itemsCount": 100,
"totalPages": 7392,
"currentPage": 1
},
"items": [
{
"rank": 1,
"user": {
"avatar": "...",
"gainId": 35276361,
"username": "darktriadclassic"
},
"score": 887350,
"reward": 50000
}
]
}
}About the Freecash API
Withdrawal Feed and Leaderboard
The get_withdrawals endpoint returns a paginated list of recent cashout transactions. Each item includes gainId, withdrawType, coins, bonus, date, username, type, avatar, and countryCode. You can filter by country using ISO 2-letter codes (US, CA, DE, GB, SE, PL, and others) or pass ALL to skip filtering. Results are ordered most-recent first. The get_leaderboard endpoint returns top earners with meta and items fields; the period parameter accepts DAILY, WEEKLY, or MONTHLY, and the source parameter is typically set to COINS.
Platform Stats and Offers
get_stats returns four headline figures shown on the Freecash homepage: total_earnings, registered_users, avg_time_to_first_cash, and average_earning_yesterday. These are returned as formatted strings (e.g. '$300,000,000+', '70M+'). get_offer_categories returns a static list of category objects, each with an id and name, representing the types of tasks users can earn from. get_featured_offers returns the current rotation of featured offer names from the homepage; the list changes as offers are swapped in and out.
Cashout Methods
get_cashout_methods returns the full list of withdrawal options available on Freecash. Each method object includes a name, icon, and type, covering cash payouts, cryptocurrencies, and gift cards. This endpoint is useful for building payout dashboards or monitoring which redemption options are currently active on the platform.
The Freecash API is a managed, monitored endpoint for freecash.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when freecash.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official freecash.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor real-time Freecash withdrawal activity filtered by country code for regional analysis.
- Build a leaderboard tracker that compares DAILY, WEEKLY, and MONTHLY top earners over time.
- Display Freecash platform stats (total earnings, registered users) in a rewards industry dashboard.
- Track which featured offers are currently live on the homepage and alert when the rotation changes.
- Enumerate available cashout methods (crypto, gift cards, cash) to compare Freecash payout options against other platforms.
- Analyze offer categories to understand which earning task types Freecash currently supports.
- Aggregate withdrawal coin amounts and bonus fields to model user earning patterns across time periods.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Freecash have an official developer API?+
What does the `get_withdrawals` endpoint return, and how do I filter by country?+
gainId, withdrawType, coins, bonus, date, username, type, avatar, and countryCode. Pass a 2-letter ISO country code (e.g. US, DE, GB) to the country_code parameter to filter results. Pass ALL to retrieve withdrawals across all countries.How current is the withdrawal feed data?+
get_withdrawals endpoint reflects the live public activity feed on Freecash, ordered most-recent first. It does not expose historical archive data beyond what appears in the current feed pagination.Does the API return individual offer details like payout amounts or completion requirements?+
get_featured_offers returns offer names only, and get_offer_categories returns category ids and names. Per-offer payout amounts, task requirements, and availability details are not covered. You can fork this API on Parse and revise it to add an endpoint targeting individual offer detail pages.Does the leaderboard endpoint expose a specific user's full earnings history?+
get_leaderboard returns the ranked list of top earners for a given period (DAILY, WEEKLY, or MONTHLY) with aggregated data. Individual user profile history is not covered by any endpoint. You can fork this API on Parse and revise it to add user-profile-level data if that surface is publicly accessible.