Community Story Rewards

Community Story Rewards lets you earn bonus credits — equal to 20% of your plan’s credit allowance — by posting about your experience using lobstr.io on an eligible subreddit. One reward is available per billing quarter, per account.

How it works

Write a genuine post or comment about your lobstr.io use case on one of the eligible subreddits.
Submit the Reddit URL via the API (or the dashboard). The post is automatically verified for content and liveness.
If approved, bonus credits are added to your account and valid until the end of your current billing period.

List eligible subreddits

Returns the list of subreddits that qualify for a reward submission.

string

required

Your API authentication token. Value: Token YOUR_API_KEY

200

{
  "results": ["SaaS", "entrepreneur", "learnpython", "MachineLearning"]
}

Submit a story

Submit a Reddit post or comment URL for review.

string

required

Your API authentication token. Value: Token YOUR_API_KEY

string

required

Must be application/json. Value: application/json

string

required

Full URL of your Reddit post or comment. Must be in an eligible subreddit. Example: https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/

Only one submission per quarter is reviewed. If an earlier submission in the same quarter was rejected you may resubmit — the most recent submission takes precedence.

Check your submission

Returns your most recent submission for the current quarter, or null if you haven’t submitted one yet.

string

required

Your API authentication token. Value: Token YOUR_API_KEY

200

{
  "submission": {
    "id": 42,
    "reddit_url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/",
    "status": "pending",
    "submitted_at": "2026-08-15T10:30:00Z",
    "quarter_key": "2026-Q3"
  }
}

Possible status values: pending (under review), gifted (approved, credits granted), rejected.

Code Example

# Check eligible subreddits
curl "https://api.lobstr.io/v1/community_rewards/subreddits" \
  -H "Authorization: Token YOUR_API_KEY"

# Submit your story
curl -X POST "https://api.lobstr.io/v1/community_rewards/submissions" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reddit_url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/"}'

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.lobstr.io/v1"
headers = {"Authorization": f"Token {API_KEY}"}

# List eligible subreddits
subreddits = requests.get(f"{BASE_URL}/community_rewards/subreddits", headers=headers).json()
print("Eligible:", subreddits["results"])

# Submit your story
response = requests.post(
    f"{BASE_URL}/community_rewards/submissions",
    headers={**headers, "Content-Type": "application/json"},
    json={"reddit_url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/"}
)
print(response.json())

Error Responses

400 SubredditNotEligible

{
  "error": "SubredditNotEligible",
  "message": "r/example isn't on the eligible-subreddit list for Community Story Rewards."
}

400 InvalidRedditUrl

{
  "error": "InvalidRedditUrl",
  "message": "That doesn't look like a Reddit comment/post URL (expected a reddit.com/r/<subreddit>/... link)."
}

Overview

Getting Started

Core Concepts

User

Crawler

Squid

Delivery

Account

Task

Run

Result

Community Story Rewards

How it works

List eligible subreddits

Submit a story

Check your submission

Code Example

Error Responses

​How it works

​List eligible subreddits

​Submit a story

​Check your submission

​Code Example

​Error Responses

How it works

List eligible subreddits

Submit a story

Check your submission

Code Example

Error Responses