Back to Replymer

Replymer API Documentation

Programmatic access to your projects, mentions, replies, keywords, and stats.

Base URL: https://replymer.com/api/v1

Contents

Authentication Rate Limits Response Format Error Codes

Account Projects Keywords Negative Keywords

Mentions Replies SEO Keywords SEO Replies Stats

Authentication

All API requests require an API key. Generate one in Settings → API Keys.

Pass your key via the X-API-Key header (recommended) or ?api_key= query parameter:

# Header (recommended)
curl -H "X-API-Key: rply_your_key_here" \
  https://replymer.com/api/v1/account

# Query parameter
curl "https://replymer.com/api/v1/account?api_key=rply_your_key_here"

Keys start with rply_ and are 45 characters long. You can have up to 3 active keys.

Rate Limits

Rate limits are per-user (not per-key) and reset every hour.

Plan	Requests / hour
Free Trial	100
Starter	500
Growth	1,000
Scale / Scale Plus / Scale Elite	Unlimited

Rate limit headers (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) are included in every response.

Response Format

All responses are JSON. Successful responses:

{
  "success": true,
  "data": { ... },
  "meta": { "page": 1, "limit": 20, "total": 142, "pages": 8 }  // paginated endpoints only
}

Error responses:

{
  "success": false,
  "error": "not_found",
  "message": "Project not found."
}

Error Codes

Code	HTTP Status	Description
`unauthorized`	401	Missing or invalid API key
`forbidden`	403	Expired subscription or insufficient permissions
`not_found`	404	Resource not found
`bad_request`	400	Invalid or missing parameters
`rate_limit_exceeded`	429	Too many requests
`plan_limit`	403	Plan resource limit reached (e.g. keywords)
`internal_error`	500	Server error

Account

GET /account

Get your account info, plan, and limits.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/account

GET /account/stats

Overall account statistics (project count, total mentions, replies, keywords).

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/account/stats

Projects

GET /projects

List all your projects.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects

GET /projects/:id

Get a single project by ID.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123

POST /projects

Create a new project. title and domain are required.

curl -X POST -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"title":"My App","domain":"https://myapp.com","description":"A cool app"}' \
  https://replymer.com/api/v1/projects

PUT /projects/:id

Update project settings. Send only fields you want to change.

Updatable fields: title, domain, description, notes, reddit, twitter, relevance, dailylimit, monthlylimit, repliesreport, twitter_handle, manual_approval

curl -X PUT -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"relevance":"medium","dailylimit":10}' \
  https://replymer.com/api/v1/projects/123

DELETE /projects/:id

Delete a project and all associated data (mentions, replies, keywords). This is irreversible.

curl -X DELETE -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123

POST /projects/:id/activate

Activate a stopped project.

curl -X POST -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/activate

POST /projects/:id/stop

Stop an active project (pauses monitoring and reply publishing).

curl -X POST -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/stop

Keywords

GET /projects/:projectId/keywords

List all keywords for a project.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/keywords

POST /projects/:projectId/keywords

Add one or more keywords. Subject to plan keyword limits.

curl -X POST -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"keywords":["saas tools","project management"]}' \
  https://replymer.com/api/v1/projects/123/keywords

DELETE /projects/:projectId/keywords/:id

Delete a keyword by ID.

curl -X DELETE -H "X-API-Key: rply_..." \
  https://replymer.com/api/v1/projects/123/keywords/456

Negative Keywords

GET /projects/:projectId/negative-keywords

List negative keywords for a project.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/negative-keywords

POST /projects/:projectId/negative-keywords

Add one or more negative keywords.

curl -X POST -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"keywords":["spam","competitor"]}' \
  https://replymer.com/api/v1/projects/123/negative-keywords

DELETE /projects/:projectId/negative-keywords/:id

Delete a negative keyword by ID.

curl -X DELETE -H "X-API-Key: rply_..." \
  https://replymer.com/api/v1/projects/123/negative-keywords/456

Mentions

GET /projects/:projectId/mentions

List mentions for a project. Paginated, filterable.

Query parameters: page (default 1), limit (default 20, max 100), status, source (Reddit/Twitter), keyword

curl -H "X-API-Key: rply_..." \
  "https://replymer.com/api/v1/projects/123/mentions?status=approved&source=Reddit&page=1&limit=50"

GET /projects/:projectId/mentions/:id

Get a single mention with full text.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/mentions/789

PUT /projects/:projectId/mentions/:id

Update mention status. Valid values: approved, declined, pending_client_approval

curl -X PUT -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"status":"approved"}' \
  https://replymer.com/api/v1/projects/123/mentions/789

Replies

GET /projects/:projectId/replies

List published replies for a project. Paginated.

curl -H "X-API-Key: rply_..." \
  "https://replymer.com/api/v1/projects/123/replies?page=1&limit=20"

GET /projects/:projectId/replies/:id

Get a single reply.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/replies/456

SEO Keywords

GET /projects/:projectId/seo-keywords

List SEO keywords for a project.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/seo-keywords

POST /projects/:projectId/seo-keywords

Add SEO keywords.

curl -X POST -H "X-API-Key: rply_..." -H "Content-Type: application/json" \
  -d '{"keywords":["best project management tool"]}' \
  https://replymer.com/api/v1/projects/123/seo-keywords

DELETE /projects/:projectId/seo-keywords/:id

Delete an SEO keyword.

curl -X DELETE -H "X-API-Key: rply_..." \
  https://replymer.com/api/v1/projects/123/seo-keywords/456

SEO Replies

GET /projects/:projectId/seo-replies

List SEO replies for a project. Paginated.

curl -H "X-API-Key: rply_..." \
  "https://replymer.com/api/v1/projects/123/seo-replies?page=1&limit=20"

GET /projects/:projectId/seo-replies/:id

Get a single SEO reply.

curl -H "X-API-Key: rply_..." https://replymer.com/api/v1/projects/123/seo-replies/456

Stats

GET /projects/:projectId/stats

Get project statistics for a given period.

Query parameters: period — number of days (1, 7, 30, or 90; default 7)

curl -H "X-API-Key: rply_..." \
  "https://replymer.com/api/v1/projects/123/stats?period=30"

Example response:

{
  "success": true,
  "data": {
    "period_days": 30,
    "total_mentions": 245,
    "total_replied": 198,
    "total_declined": 32,
    "keywords_count": 8,
    "by_source": { "Reddit": 180, "Twitter": 65 },
    "daily": [
      { "date": "2026-01-20", "mentions": 12 },
      { "date": "2026-01-21", "mentions": 8 }
    ]
  }
}