No authentication required

PeerPush API

Free REST API for product discovery. Search products, find alternatives, compare tools, and access structured data on pricing, platforms, use cases, and audiences.

Open Interactive API Explorer

Quick start

Try these examples right now — no setup needed.

Search products

Try it

bash

curl "https://peerpush.com/api/v1/products?query=email+api&limit=3"

Find alternatives

Try it

bash

curl "https://peerpush.com/api/v1/products/notion/alternatives?limit=5"

Compare products

Try it

bash

curl "https://peerpush.com/api/v1/compare?products=vercel,netlify"

Trending this week

Try it

bash

curl "https://peerpush.com/api/v1/trending?period=week&limit=5"

Endpoints

All endpoints accept GET requests and return JSON.

Endpoint	Description	Parameters
GET`/api/v1/products` Search and filter products	Search and filter products	`query, category, useCase, audience, pricingType, platforms, sort, limit, offset`
GET`/api/v1/products/:slug` Get full product details	Get full product details	`includeAlternatives, includeUpdates`
GET`/api/v1/products/:slug/alternatives` Find alternatives to a product	Find alternatives to a product	`pricingType, platforms, audience, limit, offset`
GET`/api/v1/compare` Compare products side by side	Compare products side by side	`products (comma-separated slugs)`
GET`/api/v1/trending` Get trending products	Get trending products	`category, period (day/week/month), limit, offset`
GET`/api/v1/discover` Discover products by criteria	Discover products by criteria	`useCase, audience, pricingType, platforms, category, sort, limit, offset`
GET`/api/v1/deals` Products with active discounts	Products with active discounts	`category, limit, offset`
GET`/api/v1/launches` Recently launched products	Recently launched products	`days, category, limit, offset`
GET`/api/v1/awards` Award-winning products	Award-winning products	`type (day/week/month), limit, offset`
GET`/api/v1/categories` List all categories	List all categories
GET`/api/v1/use-cases` List all use cases	List all use cases
GET`/api/v1/audiences` List all audiences	List all audiences

Response shape

All product endpoints return data in this structure.

json

{
  "data": {
    "id": "...",
    "slug": "example-product",
    "name": "Example Product",
    "tagline": "A great tool for developers",
    "description": "...",
    "websiteUrl": "https://example.com",
    "peerpushUrl": "https://peerpush.com/p/example-product",
    "logoUrl": "https://...",
    "pricing": {
      "type": "Freemium",
      "startingPrice": 9.99
    },
    "platforms": ["Web", "Api", "Cli"],
    "useCases": ["Code Development", "CI/CD"],
    "audiences": ["Developers", "Startups"],
    "categories": ["Developer Tools"],
    "community": {
      "upvotes": 142,
      "followers": 38,
      "comments": 24,
      "rating": {
        "average": 4.6,
        "count": 23,
        "weighted": 4.42
      },
      "peerPushScore": 56.5,
      "totalScore": 268
    },
    "badges": {
      "current": "Trending",
      "productOfTheDay": null,
      "productOfTheWeek": "2025-03-15T00: 00: 00.000Z",
      "productOfTheMonth": null
    },
    "social": {
      "twitterUsername": "example",
      "linkedinUrl": null
    },
    "publishedAt": "2025-02-01T12: 00: 00.000Z",
    "lastUpdatedAt": "2025-03-20T08: 30: 00.000Z",
    "uptime": {
      "status": "Online",
      "checkedAt": "2025-03-20T03: 00: 00.000Z"
    },
    "activeDeals": [
      {
        "title": "Spring sale",
        "percentOff": 25,
        "validUntil": "2025-04-30T23: 59: 59.000Z"
      }
    ]
  }
}

Field reference

Field	Type	Description
`id`	`string`	Stable internal identifier.
`slug`	`string`	URL-safe slug, also used in /p/:slug and as the path param for product endpoints.
`name`	`string`	Product name.
`tagline`	`string`	Short one-line description.
`description`	`string`	Long description.
`websiteUrl`	`string`	External product URL. Carries PeerPush UTM tags.
`peerpushUrl`	`string`	Canonical product page on peerpush.com.
`logoUrl`	`string`	CDN URL of the product logo.
`pricing.type`	`enum \| null`	One of: Free, Freemium, Subscription, OneTime, Paid.
`pricing.startingPrice`	`number \| null`	Starting price in USD, when applicable.
`platforms`	`enum[]`	Subset of: Web, Mobile, Api, Desktop, Mcp, Cli.
`useCases`	`string[]`	Controlled-vocabulary use case labels (max 3).
`audiences`	`string[]`	Controlled-vocabulary audience labels (max 3).
`categories`	`string[]`	Category labels.
`community.upvotes`	`number`	Total upvotes.
`community.followers`	`number`	Followers count.
`community.comments`	`number`	Visible comment count.
`community.rating`	`object \| null`	null when there are no public ratings; otherwise { average, count, weighted } where weighted is a Bayesian-smoothed score for ranking.
`community.peerPushScore`	`number`	PeerPush engagement points.
`community.totalScore`	`number`	Composite ranking score used internally to sort feeds.
`badges.current`	`enum`	One of: Live, Trending, ProductOfTheDay, ProductOfTheWeek, ProductOfTheMonth.
`badges.productOfTheDay`	`ISO date \| null`	When the product won Product of the Day, if ever.
`badges.productOfTheWeek`	`ISO date \| null`	When the product won Product of the Week, if ever.
`badges.productOfTheMonth`	`ISO date \| null`	When the product won Product of the Month, if ever.
`social.twitterUsername`	`string \| null`	Twitter / X handle without @.
`social.linkedinUrl`	`string \| null`	LinkedIn company page URL.
`publishedAt`	`ISO date \| null`	When the product was first published on PeerPush.
`lastUpdatedAt`	`ISO date \| null`	When the owner last posted a product update.
`uptime.status`	`enum`	Result of the most recent uptime probes. One of: Online (all recent probes succeeded), Degraded (mixed results), Offline (all recent probes failed), Unknown (no probes recorded yet).
`uptime.checkedAt`	`ISO date \| null`	When the status was last recomputed.
`activeDeals[]`	`object[]`	Currently-valid discount codes: { title, percentOff (0-100), validUntil (ISO date) }.

Rate limits

The API allows 5,000 requests per hour per IP address. Every response includes rate limit headers:

Response headers

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 5000
X-RateLimit-Reset: 1711929600

Need higher usage limits or new API endpoints? Contact us at [email protected]

Prefer AI-native access?

Connect your AI assistant directly to PeerPush via MCP. Your assistant will automatically use PeerPush when you ask about software products.

Set up MCP Submit your product