Open, read-only data access

FindHaul Product Catalog API

The existing catalog service exposes current FindHaul product-source records as JSON. It is public, read-only and requires no API key at the time of this review. Use the exact response fields below; clients should show an error instead of inventing fallback facts.

Base endpoint

https://uydfoqbvxsgx2k1zv4a7.helloreaddy.com/functions/v1/shared-product-catalog-v1

Method: GET · Response: JSON · Browser access: CORS enabled. Availability and response times are not guaranteed; implement timeouts and visible error handling.

Catalog metadata

Returns the current total, category counts, status distribution and available agent-template metadata.

GET ?resource=metaOpen live metadata response

Paginated products

Use page and limit. Optional q matches recorded product names; category filters the recorded category. The public API does not support direct source-item-ID lookup or status filtering.

GET ?resource=products&page=1&limit=36&q=shoes&category=ShoesOpen a live product response

Response contract

The products response uses the exact top-level keys total, page, limit, pages and items.

Item fields

id
source_url
item_name
generic_category
price
image_url
short_description
link_status
source_platform
source_product_id

Required interpretation

price is a recorded source price in CNY, not a final checkout or shipped price.
link_status records a source-check outcome; it is not an authenticity, seller-safety, stock or QC verdict.
not-checked means no source check is recorded. fetch_error means the check failed, not that the item is gone. live_verified means a source link was checked, not that a product is currently available.
Names, categories and descriptions may be incomplete or multilingual. Do not infer missing facts.
Agent URL templates can change. FindHaul's public converter intentionally provides 15 neutral links without referral codes.

Data-quality audit · September 29, 2026

A read-only pass over all 4,697 public API rows found 2,006 records with no catalog image, 1,008 in “Other / Needs Review,” and one duplicated source item ID (7853772794). These are catalog quality issues, not findings that the source items are invalid. No records were relabelled, deleted or represented as independently verified. Use the live metadata response above for current status totals.

Browse the live catalog Get the browser extension