RedShip

GET/api/v1/inbox

Returns a paginated list of inbox items for the authenticated user.

Parameters

Name	Type	Required	Description
`search_id`	string	No	Filter by a specific search/project
`unread_only`	boolean	No	Only return unread items
`saved_only`	boolean	No	Only return saved items
`min_score`	number	No	Minimum relevance score (0–100)
`type`	string	No	Filter by type: seo, realtime, or comment
`sort_by`	string	No	Sort: score_high, score_low, newest, oldest, upvotes, comments
`limit`	number	No	Items per page, max 100 (default: 50)
`offset`	number	No	Number of items to skip (default: 0)

Example request

curl -H "Authorization: Bearer rsp_your_key" \
"https://redship.io/api/v1/inbox?unread_only=true&min_score=70&limit=10"

Response

200

{
"data": [
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "post_id": "1abc2de",
    "post_title": "Looking for a tool to automate Reddit outreach",
    "post_url": "https://reddit.com/r/SaaS/comments/1abc2de/...",
    "post_author": "reddit_user",
    "post_subreddit": "SaaS",
    "post_content": "We've been manually replying to posts...",
    "post_created_utc": 1700000000,
    "post_score": 42,
    "post_num_comments": 15,
    "relevance_score": 85,
    "type": "seo",
    "is_read": false,
    "is_saved": false,
    "is_declined": false,
    "matched_keyword": "automation tool",
    "comment_id": null,
    "comment_content": null,
    "created_at": "2024-01-15T10:30:00Z"
  }
],
"count": 42,
"limit": 10,
"offset": 0
}