notonthehighstreet.com APInotonthehighstreet.com ↗
Access products, sellers, reviews, and categories from notonthehighstreet.com via a structured API. Search listings, fetch product details, and browse by category.
curl -X GET 'https://api.parse.bot/scraper/41ef3ecc-2511-4869-b2e8-58ffc4e69d8f/search_products?page=1&query=gifts' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination and optional sorting. Returns products from the listings API with facets, pagination metadata, and product details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| sort | string | Sort order. Accepted value: 'newest'. Only applied on page 1 via SSR fallback. |
| query | string | Search keyword (e.g. 'personalised gifts'). Omitting returns all products. |
| page_size | integer | Results per page. |
{
"type": "object",
"fields": {
"facets": "array of facet objects with key, dynamicFacet, and values",
"metadata": "object containing attributionToken",
"products": "array of product objects with title, price, partner, images, code, availability",
"pagination": "object with currentPage, totalPages, offset, pageSize, resultsReturnedThisPage, totalResults"
},
"sample": {
"data": {
"facets": [
{
"key": "price",
"values": [],
"dynamicFacet": false
}
],
"metadata": {
"attributionToken": "..."
},
"products": [
{
"code": 1515543,
"price": {
"amount": 2340,
"currency": "GBP",
"exponent": 2
},
"title": "Personalised Wifey And Hubby Travel Set",
"available": true
}
],
"pagination": {
"offset": 0,
"pageSize": 60,
"totalPages": 494,
"currentPage": 1,
"totalResults": 29599,
"resultsReturnedThisPage": 60
}
},
"status": "success"
}
}About the notonthehighstreet.com API
This API covers notonthehighstreet.com across 8 endpoints, giving programmatic access to product listings, seller profiles, customer reviews, category browsing, and search suggestions. The get_product_details endpoint returns over a dozen fields per product including pricing, variant options, HTML description, availability, and image URLs — enough to build a full product page without any supplementary requests.
Product and Search Data
The search_products endpoint accepts a query string, page, page_size, and an optional sort parameter (accepted value: newest). Responses include a products array with title, price, partner, images, code, and availability, alongside a facets array and a pagination object carrying totalResults, totalPages, currentPage, and pageSize. The get_search_suggestions endpoint takes a partial query and returns both searchTerms suggestions and partners suggestions — useful for autocomplete UIs.
Product Detail and Reviews
get_product_details requires a seller_slug and a product_slug (both drawn from the product URL). It returns the full product record: title, price (with currency, amount, and exponent), images, options for variants, a detailed attributes object, an HTML description, and an availability string. Complementary endpoints get_product_reviews and get_similar_products accept a numeric product_code. Reviews come back with per-review rating, date, comment, and any seller response, plus aggregate averageProductRating and numberOfReviews.
Sellers and Categories
get_seller_profile returns a partner object with name, id, startDate, storySummary, storyText, logo, coverImage, and location data — enough to render a full seller page. get_seller_products lists that seller's full catalogue with pagination. For category browsing, get_category_products accepts a category_path string (e.g. gifts/gifts-for-her) and returns products alongside facets and pagination metadata, mirroring the search response shape.
- Build a personalised gift recommendation engine using
search_productsquery results filtered by facets - Aggregate seller profiles and product counts to create a directory of independent UK makers
- Monitor product availability and price fields from
get_product_detailsfor price-tracking tools - Display customer sentiment dashboards using
averageProductRatingand review counts fromget_product_reviews - Power an autocomplete search bar using the
searchTermssuggestions fromget_search_suggestions - Populate a category landing page with facet-filtered product listings via
get_category_products - Surface related items in a gift-finder app using
get_similar_productsrecommendations
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does notonthehighstreet.com offer an official developer API?+
What does `get_product_details` return beyond basic listing data?+
get_product_details returns the full product record for a single item: title, price (with currency, amount, exponent), all images, options (variant choices), an attributes object, an HTML description string, and an availability status. You need both the seller_slug and product_slug from the product's URL to call it. The search and category endpoints return a lighter product shape without the full attributes or description.How does pagination work across endpoints?+
search_products, get_seller_products, get_category_products) use an integer page parameter. Responses include a pagination object with currentPage, totalPages, and totalResults. get_product_reviews also paginates via page and per_page, and its pagination object includes totalEntries and totalPages.Does the API cover order history, wishlists, or checkout data?+
Can I filter search results by price range or other facets?+
search_products endpoint returns a facets array in the response — each facet has a key and available values — but the endpoint inputs only accept query, page, page_size, and sort. Passing facet filters as query parameters is not currently supported. You can fork the API on Parse and revise the endpoint to add facet filter parameters.