Social media reward link management -- inventory, claiming, upload, and history.
Authentication
All endpoints require a Authorization: Bearer <api_key> header. Requests without a valid token receive a 401 Unauthorized response.
Base URL
/api/sm-rewards/api/sm-rewards?action=inventory
Get reward inventory counts
Returns the count of unclaimed reward links per site. Useful for checking availability before claiming.
Bearer token, e.g. "Bearer <api_key>"
200
Successful inventory lookup
{
"inventory": {
"spinblitzdotcom": 2,
"playfamedotcom": 10,
"ohhellomillions": 0,
"mcluckofficial": 5
}
}401
Missing or invalid authorization
{
"error": "Missing or invalid authorization header"
}/api/sm-rewards?action=list
List all reward links
Returns all reward links. URLs are hidden for unclaimed links to prevent leaking before a claim.
Unclaimed links have their url replaced with "[HIDDEN - claim to reveal]".
Bearer token, e.g. "Bearer <api_key>"
Filter by site. Valid: spinblitzdotcom, playfamedotcom, ohhellomillions, mcluckofficial
Filter by claim status. "true" or "false"
200
Successful list (unclaimed URLs are redacted)
{
"rewards": [
{
"id": "a1b2c3d4-...",
"url": "[HIDDEN - claim to reveal]",
"site": "spinblitzdotcom",
"claimed_by": null,
"claimed_date": null,
"date_uploaded": "2025-06-01T12:00:00.000Z"
},
{
"id": "e5f6g7h8-...",
"url": "https://spinblitz.com/reward/xyz",
"site": "spinblitzdotcom",
"claimed_by": "kaika_sm_12411",
"claimed_date": "2025-06-02T14:30:00.000Z",
"date_uploaded": "2025-06-01T12:00:00.000Z"
}
],
"count": 2
}400
Invalid site filter
{
"error": "Invalid site. Valid sites: spinblitzdotcom, playfamedotcom, ohhellomillions, mcluckofficial"
}401
Missing or invalid authorization
{
"error": "Missing or invalid authorization header"
}/api/sm-rewards?action=history
View claimed link history
Returns all claimed links with full URLs visible, ordered by most recently claimed first.
Bearer token, e.g. "Bearer <api_key>"
Filter by site. Valid: spinblitzdotcom, playfamedotcom, ohhellomillions, mcluckofficial
200
Successful history lookup
{
"history": [
{
"id": "e5f6g7h8-...",
"url": "https://spinblitz.com/reward/xyz",
"site": "spinblitzdotcom",
"claimed_by": "kaika_sm_12411",
"claimed_date": "2025-06-02T14:30:00.000Z",
"date_uploaded": "2025-06-01T12:00:00.000Z"
}
],
"count": 1
}401
Missing or invalid authorization
{
"error": "Missing or invalid authorization header"
}/api/sm-rewards?action=upload
Bulk upload new reward links
Upload one or more new reward links. Each link must include a valid URL and site name.
Valid sites: spinblitzdotcom, playfamedotcom, ohhellomillions, mcluckofficial
Each object in the "links" array must have a "url" (string) and "site" (string).
Bearer token, e.g. "Bearer <api_key>"
{
"links": [
{
"url": "https://spinblitz.com/reward/abc123",
"site": "spinblitzdotcom"
},
{
"url": "https://playfame.com/reward/def456",
"site": "playfamedotcom"
}
]
}200
Successfully uploaded
{
"inserted": [
{
"id": "new-uuid-1",
"url": "https://spinblitz.com/reward/abc123",
"site": "spinblitzdotcom",
"claimed_by": null,
"claimed_date": null,
"date_uploaded": "2025-06-03T10:00:00.000Z"
}
],
"count": 1
}400
Validation error
{
"error": "Invalid or missing \"site\" at index 0. Valid sites: spinblitzdotcom, playfamedotcom, ohhellomillions, mcluckofficial"
}401
Missing or invalid authorization
{
"error": "Missing or invalid authorization header"
}/api/sm-rewards?action=claim
Claim reward links
Claim reward links to reveal their URLs. Requires site and count. Costs 10 credits per link claimed.
Both "site" and "count" are required.
Costs 10 credits per link claimed.
Max 50 links per request.
The claimed links' full URLs are revealed in the response.
Bearer token, e.g. "Bearer <api_key>"
{
"site": "spinblitzdotcom",
"count": 2
}200
Successfully claimed
{
"claimed": [
{
"id": "a1b2c3d4-...",
"url": "https://spinblitz.com/reward/abc123",
"site": "spinblitzdotcom",
"claimed_by": "kaika_sm_12411",
"claimed_date": "2025-06-03T10:05:00.000Z",
"date_uploaded": "2025-06-01T12:00:00.000Z"
}
],
"count": 1,
"credits_remaining": 90
}400
Missing required fields
{
"error": "Required: \"site\" and \"count\". Example: {\"site\":\"spinblitzdotcom\",\"count\":2}"
}402
Insufficient credits
{
"error": "Insufficient credits. Need 20 (2 x 10), have 5.",
"credits": 5
}404
No unclaimed links available
{
"error": "No unclaimed links available for site: spinblitzdotcom"
}409
Race condition (claimed by another request)
{
"error": "Failed to claim links (may have been claimed by another request)"
}401
Missing or invalid authorization
{
"error": "Missing or invalid authorization header"
}SM Rewards API v1 -- SweepsEdge Production