Reviews and ratings

Reviews and ratings help consumers evaluate marketplace listings and help publishers build reputation. Every review includes a star rating, written feedback, and metadata about the reviewer's subscription history.

Rating system

Listings are rated on a 1 to 5 star scale. The displayed average is weighted by two factors:

This means a 5-star review from a subscriber who has been active for 6 months counts more than a 5-star review from a subscriber who joined yesterday.

Writing a review

Any organization with an active or recently cancelled subscription can submit a review.

import NPayload from '@npayload/node';

const npayload = new NPayload({ token: process.env.NPAYLOAD_TOKEN });

await npayload.marketplace.reviews.create({
  listingId: 'lst_market_prices',
  rating: 5,
  title: 'Reliable and well-documented',
  body: 'We have been using this feed for 3 months. Latency is consistently under 200ms and the schema documentation made integration straightforward. Support responds within a few hours.',
});

What makes a good review

Focus on specifics that help other consumers make decisions:

Reading reviews

Browse reviews for any listing to evaluate quality before subscribing.

// Get all reviews for a listing
const reviews = await npayload.marketplace.reviews.list({
  listingId: 'lst_market_prices',
  sortBy: 'newest',
});

for (const review of reviews.items) {
  console.log(`${review.rating}/5 - ${review.title}`);
  console.log(`  By: ${review.orgName}`);
  console.log(`  Subscribed for: ${review.subscriptionDurationDays} days`);
  console.log(`  ${review.body}`);
  if (review.publisherResponse) {
    console.log(`  Publisher reply: ${review.publisherResponse.body}`);
  }
}

Sort options

Review moderation

Reviews are moderated to maintain quality and fairness.

Automated moderation flags reviews that contain:

• Profanity or abusive language
• Personal information (email addresses, phone numbers)
• Spam or promotional content
• Reviews from organizations without an active subscription history

Manual moderation is available for disputes. Publishers or reviewers can report a review for manual review by the npayload marketplace team.

// Report a review for manual moderation
await npayload.marketplace.reviews.report('rev_abc123', {
  reason: 'inaccurate',
  details: 'The reviewer claims 50% downtime, but our monitoring shows 99.95% uptime during their subscription period.',
});

Trust signals

Beyond reviews, the marketplace surfaces additional quality indicators.

Publisher reputation score

Each publisher has an overall reputation score calculated from all their listings. The score considers:

• Average rating across all listings
• Total number of reviews
• Review response rate (percentage of reviews the publisher has replied to)
• SLA compliance history
• Account age and verification status

The reputation score is displayed on the publisher's profile and on each of their listings.

Responding to reviews

Publishers can respond publicly to any review. Responses appear directly below the review.

await npayload.marketplace.reviews.respond('rev_abc123', {
  body: 'Thank you for the feedback. We identified the latency issue you mentioned and deployed a fix on March 3rd. Average latency is now under 150ms. Please let us know if you see any further issues.',
});

Best practices for publisher responses

1. Respond to every review, positive or negative. It signals that you are engaged and care about subscriber experience.
2. Acknowledge issues. If a subscriber reports a problem, confirm whether it happened and what you did to fix it.
3. Provide timelines. If a fix is in progress, share when subscribers can expect the improvement.
4. Thank positive reviewers. A brief acknowledgment goes a long way.

How reviews affect visibility

Reviews directly influence how listings appear in marketplace search results.

Listings with no reviews still appear in search results but rank below reviewed listings with comparable metadata.

Next steps

• Listings for managing listing metadata, categories, and analytics
• Publishing for the end-to-end publishing workflow
• Consuming to subscribe to marketplace listings