Feedback API

Access customer feedback and reviews, including ratings and replies.

Endpoints Overview

Method	Endpoint	Description
`GET`	`/v1/feedback`	List all feedback
`GET`	`/v1/feedback/:id`	Get single feedback
`POST`	`/v1/feedback/:id/reply`	Reply to feedback

List Feedback

GET /v1/feedback

Query Parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`limit`	integer	Items per page (default: 25, max: 100)
`rating`	integer	Filter by rating (1-5)
`has_reply`	string	Filter by reply status (`true`/`false`)
`product_id`	string	Filter by product ID

Response

{
  "data": [
    {
      "id": "fb_abc123",
      "rating": 5,
      "comment": "Great product, instant delivery!",
      "is_auto_feedback": false,
      "seller_reply": null,
      "seller_reply_at": null,
      "buyer_email": "customer@example.com",
      "order_id": "ord_xyz789",
      "product_id": "prod_def456",
      "product_name": "Premium License",
      "created_at": "2025-01-20T15:00:00Z"
    }
  ],
  "stats": {
    "total": 156,
    "average": 4.7,
    "positive": 140,
    "negative": 16,
    "needsReply": 12
  },
  "meta": {
    "total": 156,
    "limit": 25,
    "offset": 0
  }
}

Example Request

curl -X GET "https://api.sellgate.cc/v1/feedback?rating=5" \
  -H "Authorization: Bearer sg_live_your_api_key"

Filter Unreplied Feedback

curl -X GET "https://api.sellgate.cc/v1/feedback?has_reply=false" \
  -H "Authorization: Bearer sg_live_your_api_key"

Get Feedback

GET /v1/feedback/:id

Reply to Feedback

POST /v1/feedback/:id/reply

Request Body

{
  "reply": "Thank you for your kind words! We're glad you enjoyed the product."
}

Example Request

curl -X POST "https://api.sellgate.cc/v1/feedback/fb_abc123/reply" \
  -H "Authorization: Bearer sg_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "reply": "Thank you for your feedback!"
  }'

Feedback Stats

The list endpoint includes aggregate statistics:

Field	Description
`total`	Total number of reviews
`average`	Average rating (1-5)
`positive`	Reviews with rating >= 4
`negative`	Reviews with rating < 4
`needsReply`	Reviews without a seller reply

Feedback Object

Field	Type	Description
`id`	string	Feedback identifier
`rating`	integer	Rating (1-5 stars)
`comment`	string	Customer comment
`is_auto_feedback`	boolean	Whether feedback was auto-generated
`seller_reply`	string	Seller's reply text
`seller_reply_at`	string	Reply timestamp
`buyer_email`	string	Customer email
`order_id`	string	Associated order ID
`product_id`	string	Associated product ID
`product_name`	string	Product name
`created_at`	string	Submission timestamp

Feedback API

On this page