Trust & Insight

Reviews & Ratings

Read moderated ratings and reply as a listing owner while distinguishing verified-purchase labels from review eligibility.

Updated · Guide version 1.1

Read as Markdown

Reviews contain user ratings and feedback. A verified-purchase label means the service found a completed purchase; it does not mean that only verified purchasers can submit reviews.

Read reviews

Public approved top-level reviews use GET /apps/{id}/reviews or GET /ai-agents/{id}/reviews, with page/per_page pagination. App rating distribution uses GET /apps/{id}/rating-distribution.

A signed-in user can submit feedback through the supported listing interface. The reviewed service checks duplicate reviews, performs content checks and initially stores a new review as pending. Approval is separate from submission. Read the app's actual behavior before rating it; do not post synthetic reviews for testing or promotion.

Developer replies

Open Reviews, select the relevant app and reply to a review of a listing you own. The reply request uses POST /reviews/{id}/reply with:

{"reply_text":"Thanks for reporting this. The export fix is in version 1.2.3."}

A review ID and an authorized owner session are required. The old body property is not the reply field. Authors can update or delete their own reviews with the supported account endpoints; listing ownership is not permission to edit someone else's rating.

Useful response practices

Acknowledge the specific issue, explain the available fix and link to real release notes when relevant. Do not claim a fix was shipped if it exists only in a draft. Avoid personal account details in a public response; use a private support channel for troubleshooting sensitive data.

Limitations and troubleshooting

Pending reviews will not necessarily appear in the public list or average. A completed-purchase marker is evidence about a purchase record, not an endorsement by Theaimart. There is no measured guarantee that replying raises rankings or conversions.

If a reply returns forbidden, verify that the account owns the app. If review totals differ, check moderation status and whether the view is for an app or agent. Contact support about inappropriate content rather than posting retaliatory reviews.

Next

See Releases & Versioning, Verification & Badges and Analytics.