From You Flowers APIoms.fromyouflowers.com ↗
Access From You Flowers' product catalog, pricing, categories, testimonials, and search suggestions via 5 structured API endpoints.
What is the From You Flowers 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.
curl -X GET 'https://api.parse.bot/scraper/027dbbce-4719-48df-9e36-c785f6e569ba/search_products?page=1&query=roses&category=Birthday&results_per_page=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace oms-fromyouflowers-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FromYouFlowers SDK — search, suggest, browse categories, product details, reviews."""
from parse_apis.from_you_flowers_api import FromYouFlowers, ProductDetail, ProductNotFound
client = FromYouFlowers()
# Search for rose products with a text query
for product in client.products.search(query="roses", limit=5):
print(product.name, product.price, product.image_url)
# Get autocomplete suggestions for a partial query
for match in client.products.suggest(query="tul", limit=3):
print(match.name, match.sku, match.url)
# Browse all available categories
for category in client.categories.list(limit=5):
print(category.label, category.count)
# Get detailed product info by slug — includes size variants and add-ons
detail = client.productdetails.get(url_slug="lily--rose-celebration")
print(detail.default_size, detail.url)
for variant in detail.products:
print(variant.name, variant.price, variant.label_text, variant.size)
# Read customer testimonials
for review in client.testimonials.list(limit=3):
print(review.name, review.rating, review.product_name, review.location)
# Typed error handling for a missing product
try:
missing = client.productdetails.get(url_slug="nonexistent-product-xyz")
print(missing.url)
except ProductNotFound as exc:
print(f"Product not found: {exc.url_slug}")
print("exercised: products.search / products.suggest / categories.list / productdetails.get / testimonials.list")
Search for products on FromYouFlowers.com. Supports text query search, category filtering, sorting, and pagination. Text queries use the autocomplete search API and return relevance-ranked results. Category filtering uses the catalog search API. When both query and category are provided, category filtering takes precedence. When neither is provided, returns all products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| query | string | Search query term (e.g., 'roses', 'tulips', 'birthday'). If omitted and no category specified, returns all products. |
| category | string | Filter by category name as returned by get_categories (e.g., 'Birthday', 'Roses', 'Sympathy', 'Love and Romance', 'Gift Baskets'). |
| 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": "F-224",
"url": "https://www.fromyouflowers.com/products/two_dozen_red_roses.htm",
"name": "Two Dozen Long Stemmed Red Roses",
"price": "64.99",
"category": [
"Thank You",
"Love and Romance",
"Roses"
],
"imageUrl": "https://fyf.tac-cdn.net/images/products/small/F-224.jpg",
"same_day": "false",
"description": "Make a bold statement by sending two dozen long stemmed red roses..."
}
],
"pagination": {
"end": 5,
"begin": 1,
"perPage": 5,
"nextPage": 2,
"totalPages": 198,
"currentPage": 1,
"previousPage": 0,
"totalResults": 987,
"defaultPerPage": 48
}
},
"status": "success"
}
}About the From You Flowers API
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.
The From You Flowers API is a managed, monitored endpoint for oms.fromyouflowers.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when oms.fromyouflowers.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official oms.fromyouflowers.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.