Skip to content

Comment Moderation ​

A practical guide to moderating comments across your connected social media platforms using the Repliz API.

Overview ​

Comment moderation in Repliz works through a queue-based system. Comments from all connected platforms get pulled into a centralized queue where you can review, reply, and categorize them.

The Comment Queue ​

How Comments Enter the Queue ​

When someone comments on any of your connected social media accounts, Repliz automatically picks it up and stores it in the queue. Each comment entry includes:

  • Content info: the original post where the comment was made
  • Comment details: the comment text, author, and any media attachments
  • Account reference: which of your connected accounts received the comment
  • Status: the current moderation status (pending, resolved, or ignored)

Fetching Comments ​

Retrieve comments with filtering options:

bash
# Get all pending comments
curl -X GET "https://api.repliz.com/public/comment?page=1&limit=20&status=pending" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

# Filter by specific accounts
curl -X GET "https://api.repliz.com/public/comment?page=1&limit=20&accountIds[]=ACCOUNT_ID" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

# Search comments by text
curl -X GET "https://api.repliz.com/public/comment?page=1&limit=20&search=thank%20you" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

Moderation Workflow ​

1. Review Pending Comments ​

Start by fetching all pending comments:

bash
curl -X GET "https://api.repliz.com/public/comment?page=1&limit=50&status=pending" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

2. Reply to Comments ​

When a comment needs a response, use the Reply API:

bash
curl -X POST "https://api.repliz.com/public/comment/COMMENT_ID" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Thank you for your kind words! We appreciate your support. 🙏"
  }'

The reply is posted directly to the original platform where the comment was made.

3. Update Comment Status ​

After handling a comment, update its status to keep your queue clean:

bash
# Mark as resolved
curl -X PUT "https://api.repliz.com/public/comment/COMMENT_ID/status" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "status": "resolved" }'

# Mark as ignored (spam or irrelevant)
curl -X PUT "https://api.repliz.com/public/comment/COMMENT_ID/status" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "status": "ignored" }'

Content-Level Comment Management ​

For more granular control, you can manage comments directly at the post level using the Content API.

View Comments on a Specific Post ​

bash
curl -X GET "https://api.repliz.com/public/content/CONTENT_ID/comment?page=1&limit=20" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

Post a New Comment on Content ​

bash
curl -X POST "https://api.repliz.com/public/content/CONTENT_ID/comment" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Great discussion happening here!"
  }'

Delete a Comment ​

Remove inappropriate or spam comments directly from the platform:

bash
curl -X DELETE "https://api.repliz.com/public/content/CONTENT_ID/comment/PLATFORM_COMMENT_ID" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)"

Best Practices ​

Response Time ​

  • Try to reply to comments within 1-2 hours for the best engagement
  • Use the status=pending filter to prioritize new comments
  • Set up scheduled checks to regularly fetch and process incoming comments

Automation Tips ​

  1. Keyword filtering: use the search parameter to find comments with specific keywords.
  2. Batch processing: fetch comments in bulk with higher limit values for faster moderation.
  3. Account prioritization: use accountIds to focus on your highest-traffic accounts first.
  4. Status tracking: always update a comment's status after you handle it to keep your queue clean.

Handling Spam ​

  1. Fetch pending comments and look for spam indicators
  2. Mark spam comments as ignored using the status update endpoint
  3. Use the Content API to delete spam comments from the platform directly

TIP

Combine the Comment Queue API with the Content API for a complete moderation workflow. Use the queue for incoming comment notifications, and the Content API for direct platform-level actions.