Search Product Hunt

Try in Playground

Search Product Hunt by keyword across products, launches, users, topics, discussions, categories and stories, or restrict results to one type. Each result carries a type and that record's fields. Page with cursor.

GET/v1/producthunt/searchx-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

querystringrequiredquery

Required search text, 1–200 characters.

min 1 chars · max 200 chars

Examplenotion

typeenumquery

all (default), products, launches, users, topics, discussions, categories or stories.

one of: all, products, launches, users, topics, discussions, categories, stories

Exampleproducts

cursorstringquery

Opaque nextCursor from the previous page. Omit for the first page.

limitstringquery

Records per page, 1–20; defaults to 20 (the source's page ceiling).

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.

querystring

Required search text, 1–200 characters.

typeenum

all (default), products, launches, users, topics, discussions, categories or stories.

one of: all, products, launches, users, topics, discussions, categories, stories

Results in source relevance order. type is Product, Post (a launch), User, Topic, DiscussionThread, ProductCategory or AnthologiesStory; the remaining fields match that record type in the product, launch, profile, topic, forum, category and story endpoints.

up to 20 items

results.idstring

Always included.

results.slugstringoptional

Optional.

results.namestring | stringoptional

Optional.

results.taglinestringnullableoptional

Optional.

results.urlstring

Always included.

results.websiteUrlstringnullableoptional

Optional.

results.logoUuidstringnullableoptional

Optional.

results.logoUrlstringnullableoptional

Optional.

results.reviewsRatingnumbernullableoptional

Optional.

results.reviewsCountintegeroptional

Optional.

results.followersCountintegeroptional

Optional.

results.postsCountintegeroptional

Optional.

results.isTopProductbooleanoptional

Optional.

results.isNoLongerOnlinebooleanoptional

Optional.

results.typestring

Source record type.

results.createdAtstringoptional

Optional.

results.featuredAtstringnullableoptional

Optional.

results.scheduledAtstringnullableoptional

Optional.

results.votesCountintegernullableoptional

Optional.

results.hideVotesCountbooleanoptional

Optional.

results.commentsCountintegeroptional

Optional.

results.dailyRankstringnullableoptional

Optional.

results.weeklyRankstringnullableoptional

Optional.

results.monthlyRankstringnullableoptional

Optional.

results.thumbnailImageUuidstringnullableoptional

Optional.

results.thumbnailImageUrlstringnullableoptional

Optional.

results.user.idstring

Always included.

results.user.namestringnullable

Always included.

results.user.usernamestring

Always included.

results.user.headlinestringnullable

Always included.

results.user.avatarUrlstringnullable

Always included.

results.user.urlstring

Always included.

Optional.

results.product.idstring

Always included.

results.product.slugstring

Always included.

results.product.namestring

Always included.

Optional.

up to 50 items

results.topics.idstring

Always included.

results.topics.slugstring

Always included.

results.topics.namestring

Always included.

results.usernamestringoptional

Optional.

results.headlinestringnullableoptional

Optional.

results.avatarUrlstringnullableoptional

Optional.

results.descriptionstringnullableoptional

Optional.

results.imageUuidstringnullableoptional

Optional.

results.imageUrlstringnullableoptional

Optional.

results.pathstringoptional

Optional.

results.titlestringoptional

Optional.

results.descriptionPreviewstringnullableoptional

Optional.

results.minsToReadintegernullableoptional

Optional.

results.publishedAtstringnullableoptional

Optional.

results.headerImageUuidstringnullableoptional

Optional.

results.headerImageUrlstringnullableoptional

Optional.

results.author.idstring

Always included.

results.author.namestringnullable

Always included.

results.author.usernamestring

Always included.

results.author.headlinestringnullable

Always included.

results.author.avatarUrlstringnullable

Always included.

results.author.urlstring

Always included.

totalCountintegernullable

Total records the source reports for this list, or null when it does not report one.

nextCursorstringnullable

Pass as cursor to read the next page; null on the last page.

hasMoreboolean

Whether another page exists.

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/search?query=notion&type=products" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/producthunt/search?query=notion&type=products",
  {
    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/search?query=notion&type=products",
  {
    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/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "notion",
        "type": "products"
    },
    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/search?query=notion&type=products", 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/search?query=notion&type=products"))
            .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.

{
  "query": "synthetic",
  "type": "all",
  "results": [
    {
      "type": "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
    },
    {
      "type": "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"
      },
      "topics": [
        {
          "id": "46",
          "slug": "productivity",
          "name": "Synthetic"
        }
      ]
    },
    {
      "type": "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"
    },
    {
      "type": "Topic",
      "id": "46",
      "slug": "productivity",
      "name": "Productivity",
      "description": "Synthetic topic",
      "followersCount": 9,
      "imageUuid": "topic-uuid.png",
      "imageUrl": "https://ph-files.imgix.net/topic-uuid.png",
      "path": "/topics/productivity",
      "url": "https://www.producthunt.com/topics/productivity"
    },
    {
      "type": "DiscussionThread",
      "id": "81",
      "slug": "synthetic-thread",
      "title": "Synthetic thread",
      "descriptionPreview": null,
      "createdAt": "2026-07-22T05:50:38-07:00",
      "commentsCount": 4,
      "votesCount": 3,
      "path": "/p/general/synthetic-thread",
      "url": "https://www.producthunt.com/p/general/synthetic-thread",
      "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"
      }
    },
    {
      "type": "ProductCategory",
      "id": "35",
      "slug": "notes",
      "name": "Notes",
      "description": "Synthetic category",
      "path": "/categories/notes",
      "url": "https://www.producthunt.com/categories/notes"
    },
    {
      "type": "AnthologiesStory",
      "id": "71",
      "slug": "synthetic-story",
      "title": "Synthetic story",
      "description": "",
      "minsToRead": 3,
      "publishedAt": "2025-11-14T09:00:00-08:00",
      "headerImageUuid": null,
      "headerImageUrl": null,
      "url": "https://www.producthunt.com/stories/synthetic-story",
      "author": {
        "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"
      }
    }
  ],
  "totalCount": 1000,
  "nextCursor": "UmFuazo3",
  "hasMore": true,
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.producthunt.com/search?q=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."
  }
}