Get a Product Hunt launch

Try in Playground

Retrieve one Product Hunt launch: tagline, description, votes, score, comments, daily/weekly/monthly ranks, launch number, pricing, hunter, makers, topics, gallery media, links, the product and its day and Golden Kitty badges.

GET/v1/producthunt/postx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

slugstringrequiredquery

Required launch slug, as in producthunt.com/posts/<slug> or the launch parameter of a product page (for example notion-2-0).

Examplesolid-9

Response fields

requestIdstring

Request correlation identifier.

HTTP attempts, decoded bytes and duration for the operation, including the single shared retry.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned; inspect status and coverage for omissions.

statusenum

success, partial, failed, or challenged. HTTP 200 can be partial.

one of: success, partial

sourceUrlstring

Public Product Hunt page for the request.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

source is public_api (Product Hunt's public web GraphQL) or public_feed (the Atom launch feed). Complete means this bounded page was returned without known omissions; votes_hidden marks launches whose vote count Product Hunt hides during their first hours (returned as null).

coverage.sourceenum

Always included.

one of: public_api, public_feed

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

The launch record.

post.idstring

Launch (post) ID as a string.

post.slugstring

Launch slug; read it with the post endpoint.

post.namestring

Launch name.

post.taglinestringnullable

One-line tagline.

post.descriptionstringnullable

Launch description (HTML), or null.

post.urlstring

Public launch or product page URL.

post.shortenedUrlstringnullable

Relative short link, or null.

post.createdAtstring

Creation time with the source's Pacific-time offset.

post.featuredAtstringnullable

Time the launch was featured, or null.

post.scheduledAtstringnullable

Scheduled launch time, or null.

post.votesCountintegernullable

Upvote count; null while Product Hunt hides votes (hideVotesCount true).

post.hideVotesCountboolean

True during the launch's hidden-vote window.

post.latestScoreintegernullable

Product Hunt's current ranking score, or null.

post.launchDayScoreintegernullable

Score at the end of launch day, or null.

post.commentsCountinteger

Comment count.

post.dailyRankstringnullable

Rank on its launch day as a string, or null before ranking.

post.weeklyRankstringnullable

Rank for its week as a string, or null.

post.monthlyRankstringnullable

Rank for its month as a string, or null.

post.launchNumberintegernullable

Which launch of the product this is, or null.

post.launchStatestringnullable

Launch state such as featured, or null.

post.pricingTypestringnullable

Pricing type, or null.

post.isArchivedboolean

Whether the launch is archived.

post.thumbnailImageUuidstringnullable

Thumbnail image identifier, or null.

post.thumbnailImageUrlstringnullable

Thumbnail image URL derived from thumbnailImageUuid, or null.

The hunter who submitted the launch, or null.

post.user.idstring

Product Hunt user ID (string).

post.user.namestringnullable

Display name.

post.user.usernamestring

Username, as in producthunt.com/@username.

post.user.headlinestringnullable

Profile headline, or null.

post.user.avatarUrlstringnullable

Avatar image URL, or null.

post.user.urlstring

Public profile URL.

Makers credited on the launch.

up to 50 items

post.makers.idstring

Product Hunt user ID (string).

post.makers.namestringnullable

Display name.

post.makers.usernamestring

Username, as in producthunt.com/@username.

post.makers.headlinestringnullable

Profile headline, or null.

post.makers.avatarUrlstringnullable

Avatar image URL, or null.

post.makers.urlstring

Public profile URL.

Topics: id, slug and name.

up to 50 items

post.topics.idstring

Always included.

post.topics.slugstring

Always included.

post.topics.namestring

Always included.

Gallery media with imageUrl.

up to 50 items

post.media.idstring

Always included.

post.media.imageUuidstringnullable

Always included.

post.media.imageUrlstringnullable

Always included.

post.media.mediaTypestring

Always included.

post.media.originalWidthintegernullable

Always included.

post.media.originalHeightintegernullable

Always included.

post.media.metadata.urlstringnullable

Always included.

post.media.metadata.videoIdstringnullable

Always included.

post.media.metadata.platformstringnullable

Always included.

Launch links: id and url.

up to 50 items

post.links.idstring

Always included.

post.links.urlstringnullable

Always included.

Primary website link, or null.

post.primaryLink.idstring

Always included.

post.primaryLink.urlstringnullable

Always included.

The product with its rating and counts, or null.

post.product.idstring

Product ID as a string.

post.product.slugstring

Product slug, as in producthunt.com/products/<slug>.

post.product.namestring

Product name.

post.product.taglinestringnullable

Product tagline.

post.product.urlstring

Product page URL.

post.product.websiteUrlstringnullable

The product's own website, or null.

post.product.logoUuidstringnullable

Logo image identifier, or null.

post.product.logoUrlstringnullable

Logo image URL derived from logoUuid, or null.

post.product.reviewsRatingnumbernullable

Average review rating out of 5, or null.

post.product.reviewsCountinteger

Review count.

post.product.followersCountinteger

Follower count.

post.product.postsCountinteger

Number of launches.

post.product.isTopProductboolean

Whether Product Hunt marks it a top product.

post.product.isNoLongerOnlineboolean

Whether the product is marked as no longer online.

Day/week/month and Golden Kitty badges: type, position, period, date, category, year.

up to 50 items

post.badges.typestring

Always included.

post.badges.idstring

Always included.

post.badges.positionintegernullableoptional

Optional.

post.badges.periodstringnullableoptional

Optional.

post.badges.datestringnullableoptional

Optional.

post.badges.categorystringnullableoptional

Optional.

post.badges.yearstringnullableoptional

Optional.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with votes_hidden warnings.
400	`invalid_request`	Missing, duplicate, malformed or unsupported parameters, including incomplete or impossible leaderboard dates.
401	`unauthorized`	Missing or invalid worker API key.
404	`not_found`	The product, launch, comment, topic, category, forum, discussion or user does not exist.
429	`upstream_rate_limited`	Source throttling; no automatic retry.
502	`upstream_challenged`	Source rejected or challenged the unauthenticated request.
502	`unsupported_page`	Malformed, mismatched or non-JSON source data, or a GraphQL error.
502	`response_too_large` `payload_too_complex`	Response exceeded byte or parsing limits.
502	`unsafe_redirect` `request_limit` `upstream_error`	Bounded source retrieval could not complete.
503	`busy`	All worker slots are occupied.
504	`timeout`	Total request deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/producthunt/post?slug=solid-9" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/producthunt/post?slug=solid-9",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/producthunt/post?slug=solid-9",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Product Hunt request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/producthunt/post",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "slug": "solid-9"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/producthunt/post?slug=solid-9", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/producthunt/post?slug=solid-9"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "post": {
    "id": "501",
    "slug": "synthetic-launch",
    "name": "Synthetic Launch",
    "tagline": "A synthetic tagline",
    "url": "https://www.producthunt.com/products/synthetic",
    "createdAt": "2026-09-23T00:01:00-07:00",
    "featuredAt": "2026-09-23T00:01:00-07:00",
    "scheduledAt": "2026-09-23T00:01:00-07:00",
    "votesCount": 420,
    "hideVotesCount": false,
    "commentsCount": 12,
    "dailyRank": "1",
    "weeklyRank": null,
    "monthlyRank": null,
    "thumbnailImageUuid": "thumb-uuid.png",
    "thumbnailImageUrl": "https://ph-files.imgix.net/thumb-uuid.png",
    "user": {
      "id": "101",
      "name": "Example Maker",
      "username": "example_maker",
      "headline": "Builds synthetic tools",
      "avatarUrl": "https://ph-avatars.imgix.net/101/synthetic.png",
      "url": "https://www.producthunt.com/@example_maker"
    },
    "product": {
      "id": "301",
      "slug": "synthetic",
      "name": "Synthetic",
      "tagline": "A synthetic product",
      "url": "https://www.producthunt.com/products/synthetic",
      "websiteUrl": "https://example.test",
      "logoUuid": "logo-uuid.png",
      "logoUrl": "https://ph-files.imgix.net/logo-uuid.png",
      "reviewsRating": 4.5,
      "reviewsCount": 3,
      "followersCount": 50,
      "postsCount": 2,
      "isTopProduct": false,
      "isNoLongerOnline": false
    },
    "topics": [
      {
        "id": "46",
        "slug": "productivity",
        "name": "Synthetic"
      }
    ],
    "description": "<p>Synthetic</p>",
    "shortenedUrl": "/r/p/501",
    "latestScore": 300,
    "launchDayScore": 280,
    "launchNumber": 2,
    "launchState": "featured",
    "pricingType": null,
    "isArchived": false,
    "makers": [
      {
        "id": "103",
        "name": "Example Maker",
        "username": "example_maker",
        "headline": "Builds synthetic tools",
        "avatarUrl": "https://ph-avatars.imgix.net/101/synthetic.png",
        "url": "https://www.producthunt.com/@example_maker"
      }
    ],
    "media": [
      {
        "id": "61",
        "imageUuid": "media-uuid.png",
        "imageUrl": "https://ph-files.imgix.net/media-uuid.png",
        "mediaType": "image",
        "originalWidth": 1270,
        "originalHeight": 760,
        "metadata": {
          "url": null,
          "videoId": null,
          "platform": null
        }
      }
    ],
    "links": [
      {
        "id": "1",
        "url": "https://example.test"
      }
    ],
    "primaryLink": {
      "id": "1",
      "url": "https://example.test"
    },
    "badges": [
      {
        "type": "TopPostBadge",
        "id": "5",
        "position": 1,
        "period": "daily",
        "date": "2026-09-23"
      }
    ]
  },
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.producthunt.com/products/synthetic",
  "fetchedAt": "2026-09-24T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 4200,
    "durationMs": 340
  }
}

Missing, duplicate, malformed or unsupported parameters, including incomplete or impossible leaderboard dates.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}