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 or as a LinkedIn post. One reward is available per billing quarter, per account.

How it works

Write a genuine post about your lobstr.io use case on one of the eligible subreddits or publish a standalone LinkedIn post.
Submit the Reddit or LinkedIn 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, along with the exact credit amount the authenticated user would receive if approved.

string

required

Your API authentication token. Value: Token YOUR_API_KEY

200

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

estimated_reward_credits is the actual credit amount you would earn — 20% of your plan’s execution credits, computed server-side using the same formula as the grant. null if you have no active subscription.

Submit a story

Submit a Reddit or LinkedIn post 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 LinkedIn post. For Reddit, must be in an eligible subreddit. Example: https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/ or https://www.linkedin.com/posts/yourname_activity-123456789/

string

Platform of the submission: reddit (default) or linkedin. When omitted, reddit is assumed. LinkedIn posts have no subreddit allowlist — any public standalone post is eligible.

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,
    "platform": "reddit",
    "url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/",
    "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 a Reddit story
curl -X POST "https://api.lobstr.io/v1/community_rewards/submissions" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/", "platform": "reddit"}'

# Submit a LinkedIn story
curl -X POST "https://api.lobstr.io/v1/community_rewards/submissions" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/posts/yourname_activity-123456789/", "platform": "linkedin"}'

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 a Reddit story
response = requests.post(
    f"{BASE_URL}/community_rewards/submissions",
    headers={**headers, "Content-Type": "application/json"},
    json={"url": "https://www.reddit.com/r/SaaS/comments/abc123/my_lobstr_experience/", "platform": "reddit"}
)
print(response.json())

# Submit a LinkedIn story
response = requests.post(
    f"{BASE_URL}/community_rewards/submissions",
    headers={**headers, "Content-Type": "application/json"},
    json={"url": "https://www.linkedin.com/posts/yourname_activity-123456789/", "platform": "linkedin"}
)
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)."
}

400 InvalidLinkedinUrl

{
  "error": "InvalidLinkedinUrl",
  "message": "That doesn't look like a LinkedIn post URL (expected a linkedin.com/posts/... or linkedin.com/feed/update/urn:li:activity:... link)."
}

400 LinkedinCommentNotEligible

{
  "error": "LinkedinCommentNotEligible",
  "message": "That's a link to a comment. The LinkedIn program is for standalone posts only — please submit the URL of your post itself."
}

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