Documentation

Scrape a product URL and generate a listing draft.

Verify actual uploaded bytes and reserved size/type before attaching an image. Returns URL; at most 8 distinct images per listing including logo and cover.

Upload a local image: obtain a 15-minute signed PUT URL, upload bytes, then complete_listing_image_upload. Exact size, at most 2 MB. JPEG/PNG/WebP/GIF only.

Delete an uploaded image you own. Remove it from the listing and save first. Frees an unattached upload slot.

Get full details of a listing you own (for editing).

Read views, clicks, and a view-to-click ratio for a Directory Pro product you own. There is no source attribution. Free products receive PRO_REQUIRED.

Generate a listing draft from a Product Hunt post URL.

List listings owned by the authenticated user.

Publish an update on a Directory Pro product you own. Free products cannot post updates. Questions stay free.

Create a product listing you own. publication: publish (default), draft to keep it private while preparing, or schedule with scheduled_publish_at. Free includes 2 distinct images, Directory Pro 8; logo, cover, gallery and thumbnails count once per URL; each image at most 2 MB.

Update a product you own. A free product can keep a grandfathered image set only when the URLs do not change. Any real image change must fit 2 images, or 8 after Directory Pro. Do not send is_pro or an image limit; the server decides.

Upload an image URL or base64 image to Directory storage. Maximum 2 MB, JPEG/PNG/WebP/GIF. Free products can use 2 distinct images and Directory Pro products can use 8, including logo and cover. The same URL counts once. Pass listing_id so the server enforces that product limit. At most 2 uploads may remain unattached.

Crawl a listing website and confirm the lots.directory badge backlink exists.

Score a product listing against the quality checklist. Requires the Pro pack.

Generate improved tagline/description/about for a product. Returns proposed copy to apply. Requires the Pro pack.

List published backlinks earned for a product and progress counts. Requires the Pro pack.

Audit a product landing page for conversion/quality. Requires the Pro pack.

List past AI content reviews for a product you own.

List past landing page audits for a product you own.

Answer a question on a listing you own.

List questions asked on your products (to answer).

List the authenticated user notifications.

Mark one or all notifications read.

Get a category with its published products.

Get a curated collection and its products by slug.

List all published products by a maker username.

Get a maker profile by username.

Get a single published product by slug.

List all directory categories.

List curated product collections (best-of, alternatives).

List published directory products with filters and sorting.

List all tags used across the directory.

Typeahead search across published products.

Get the authenticated maker profile.

Update the authenticated user maker profile.