oms.fromyouflowers.com APIoms.fromyouflowers.com ↗
Access From You Flowers' product catalog, pricing, categories, testimonials, and search suggestions via 5 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/027dbbce-4719-48df-9e36-c785f6e569ba/search_products?page=1&query=birthday&category=Birthday&results_per_page=48' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products using Searchspring API. Supports query, category filtering, sorting, and pagination. When no query is provided, returns all products. When a category is specified, filters results to that category.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| query | string | Search query term (e.g., 'birthday', 'tulips'). If omitted, returns all products. |
| category | string | Filter by category name as returned by get_categories (e.g., 'Birthday', 'Roses', 'Sympathy'). |
| results_per_page | integer | Number of results per page. |
{
"type": "object",
"fields": {
"facets": "array of facet objects for filtering",
"results": "array of product objects with name, price, url, imageUrl, sku, description, category",
"pagination": "object with totalResults, currentPage, totalPages, perPage, nextPage"
},
"sample": {
"data": {
"facets": [],
"results": [
{
"sku": "V7010",
"url": "https://www.fromyouflowers.com/products/lily--rose-celebration.htm",
"name": "Rose & Lily Celebration",
"price": "44.99",
"category": [
"Funeral",
"Thank You",
"Love and Romance"
],
"imageUrl": "https://fyf.tac-cdn.net/images/products/small/V7010.jpg"
}
],
"pagination": {
"perPage": 48,
"nextPage": 2,
"totalPages": 10,
"currentPage": 1,
"totalResults": 457
}
},
"status": "success"
}
}About the oms.fromyouflowers.com API
The From You Flowers API exposes 5 endpoints for querying the full floral and gift product catalog at fromyouflowers.com. You can search by keyword or category with search_products, retrieve per-product variant details including size options and add-ons with get_product_details, and pull paginated customer testimonials with star ratings and product references. Responses include structured fields for price, SKU, image URLs, and availability across size variants.
Product Search and Browsing
The search_products endpoint accepts a query string (e.g., 'birthday', 'tulips'), an optional category filter using values returned by get_categories, a sort parameter, and page/results_per_page for pagination. Responses include a results array of product objects — each with name, price, url, imageUrl, sku, description, and category — plus a facets array for further filtering and a pagination object exposing totalResults, currentPage, totalPages, perPage, and nextPage.
Product Details and Variants
get_product_details takes a url_slug extracted from product URLs returned by search_products (e.g., 'lily--rose-celebration' from /products/lily--rose-celebration.htm). It returns a products array of variant objects, each with name, sku, price, size, imageUrl, addons, and description. The response also includes defaultSize indicating which size is pre-selected, and an alternativeImages array of additional image URLs for the product.
Categories and Autocomplete
get_categories returns a flat list of category objects with label, value, and count fields — giving an accurate picture of catalog depth per category. The value field is what search_products accepts as its category parameter. get_search_suggestions accepts a partial query string and returns matching product results alongside facets and pagination, making it suitable for building typeahead search interfaces. Note that the results field in this endpoint returns an HTML snippet rather than a structured array.
Customer Testimonials
get_testimonials returns paginated customer reviews at 30 records per page. Each record includes name, location, text, rating, date, and productName, allowing you to associate reviews with specific products. The totalRowCount field indicates the full size of the testimonials dataset.
- Build a floral gift search tool that filters results by category and sorts by price using
search_products. - Aggregate product variant pricing across sizes for competitive price monitoring via
get_product_details. - Populate a gift recommendation widget with category counts from
get_categoriesto guide user navigation. - Implement a typeahead search bar for flowers and gifts using partial query strings with
get_search_suggestions. - Collect and display customer testimonials with star ratings and product references using
get_testimonials. - Track SKUs and image URLs across the catalog for affiliate product feed generation.
- Identify available add-on options per product variant to surface upsell opportunities.
| 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 From You Flowers have an official public developer API?+
What does `get_product_details` return beyond a basic product listing?+
get_product_details returns a products array of variant objects, where each variant includes its own sku, price, size, imageUrl, and addons list. It also returns defaultSize (the pre-selected size on the product page) and an alternativeImages array. This gives you full size-tier pricing for a single product in one call.Does the search suggestions endpoint return structured product objects?+
results field in get_search_suggestions returns an HTML snippet rather than a structured product array. It does include a pagination object with totalResults, currentPage, and totalPages, and a facets array. If you need structured product data from a partial query, search_products with a query parameter returns fully parsed product objects instead.Does this API cover order placement, delivery scheduling, or account data?+
How does pagination work across endpoints that support it?+
search_products accepts page and results_per_page parameters and returns a pagination object with totalResults, currentPage, totalPages, perPage, and nextPage. get_testimonials accepts a page parameter and always returns 30 records per page, with totalRowCount indicating the full dataset size. get_categories and get_product_details do not paginate.