List Product Comments

Retrieves a list of all product comments with filtering, searching, and ordering capabilities.

HTTP Request

GET/api/products/comments/

NOTE: NOT USING THE TRAILING SLASH AT THE END OF THE URL RESULTS TO AN INTERNAL REDIRECT WITH 301 STATUS

Authorization

Authorization

• Required: Yes
• Permission: Staff with ProductCommentPermission or Admin
• Permission Code: 1882
• Authentication: Token-based (Authorization: Token <your_api_key>)

Query Parameters

Parameter	Type	Default	Description
limit	integer	10	Number of results to return per page
offset	integer	0	Number of results to skip before returning results
search	string	—	Search term to lookup results by(`id`, `content`, `product__id`, `product__title`, `product_slug`, `user__id`, `user__username`, `user__mobile_number`, `user__first_name`, `user__last_name`)
ordering	string	-created_at	Order results by (`id`, `user`, `product`, `rating`, `is_published`, `updated_at`, `created_at`)
id_min	integer	—	Minimum ID filter
id_max	integer	—	Maximum ID filter
created_date	string	—	Filter by creation date (e.g., 2023-01-01)
updated_date	string	—	Filter by last updated date (e.g., 2023-01-01)
created_from	string	—	Filter by creation date range start
created_to	string	—	Filter by creation date range end
updated_from	string	—	Filter by last updated date range start
updated_to	string	—	Filter by last updated date range end
is_anonymous	boolean	—	Filter comments that are anonymouse/not anonymouse
is_published	boolean	—	Filter comments that are published/not published
rating_min	integer	—	Minimum rating filter (1-5)
rating_max	integer	—	Maximum rating filter (1-5)
product	integer	—	Filter by specific product ID
product_in	string	—	Filter by multiple product IDs (comma-separated: 1,2,3)
user	integer	—	Filter by specific user ID
user_in	string	—	Filter by multiple user IDs (comma-separated: 1,2,3)

Example Requests

🐍 Python

1import requests
2
3# List all product comments
4response = requests.get('http://www.example.com/api/products/comments', 
5  headers={'Authorization': 'Token <your_api_key>'}
6)
7print(response.json())
8
9# Search for comments with filters
10response = requests.get('http://www.example.com/api/products/comments', params={
11  'search': 'great product',
12  'is_published': True,
13  'rating_min': 4,
14  'ordering': '-created_at',
15  'limit': 20
16}, headers={'Authorization': 'Token <your_api_key>'})
17print(response.json())
18
19# Filter by specific product and rating range
20response = requests.get('http://www.example.com/api/products/comments', params={
21  'product': 5,
22  'rating_min': 3,
23  'rating_max': 5,
24  'is_published': True
25}, headers={'Authorization': 'Token <your_api_key>'})
26print(response.json())

🌐 Curl

1# List all product comments
2curl "http://www.example.com/api/products/comments" -H "Authorization: Token <your_api_key>"
3
4# Search with filters
5curl "http://www.example.com/api/products/comments?search=great%20product&is_published=true&rating_min=4&ordering=-created_at&limit=20" \
6-H "Authorization: Token <your_api_key>"
7
8# Filter by specific product and rating range
9curl "http://www.example.com/api/products/comments?product=5&rating_min=3&rating_max=5&is_published=true" \
10-H "Authorization: Token <your_api_key>"

Response Fields

Field	Type	Description
count	Integer	Total number of categories
next	String	URL for the next page of results
previous	String	URL for the previous page of results
results	Array[Object]	Array of ProductComment objects

ProductComment Object Structure

Field	Type	Description
id	integer	Unique ID of the comment
rating	integer	Rating given (1-5: Worst, Bad, Average, Good, Best)
content	string	Comment content (max 500 characters)
is_anonymous	boolean	Whether the comment is posted anonymously
is_published	boolean	Whether the comment is published
user_data	object	User details (nullable)
product_data	object	Product details (read-only)
truncated_content	string	Shortened version of content
created_at	string (ISO 8601)	Timestamp when comment was created
updated_at	string (ISO 8601)	Timestamp when comment was last updated

User Data Structure

Field	Type	Description
id	integer	Unique ID of the user
username	string	Username of the user
full_name	string	Full name of the user
avatar	string	URL of the user avatar image

Product Data Structure

Field	Type	Description
id	integer	Unique ID of the product
title	string	Title of the product

Example Response

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1,
            "rating": 3,
            "content": "واقعا ماوس خوبی است",
            "is_anonymous": false,
            "is_published": false,
            "created_at": "2025-11-22T15:24:49.833816Z",
            "updated_at": "2025-11-22T15:24:49.833821Z",
            "user_data": {
                "id": 2,
                "username": "staffer",
                "full_name": "عماد رخشانی",
                "avatar": "http://127.0.0.1:8000/media/users/avatars/Fantasticheskie_kartinki_dlja_monitora_68_76.jpg"
            },
            "product_data": {
                "id": 36,
                "title": "ماوس لاجیتک MX Vertical"
            },
            "truncated_content": "واقعا ماوس خوبی است"
        }
    ]
}

Notes

• Rating scale: 1=Worst, 2=Bad, 3=Average, 4=Good, 5=Best