1-800-Flowers Public Catalog API
Live, read-only access to useful public 1-800-Flowers catalog workflows. Start with trending search phrases, search products with source pagination, facets and ordering, follow a returned canonical product URL to structured detail, or retrieve SKU-level pricing by a part number returned by search. Reads use the site's public HTTP endpoints and do not perform cart, checkout, account, or other website mutations.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the 1-800-Flowers Public Catalog API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/9f66715d-5266-44d5-ac03-cbdb5c8b0263/v1/catalog/categories' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETCatalog categories/v1/catalog/categories
Read the current same-origin main-navigation category links from the public homepage. Each returned choice includes its canonical URL and, when the source exposes a numeric category identifier in that URL, the identifier needed by category-products. The menu is current and non-exhaustive; account, cart, and external corporate links are omitted.
Input
No input parameters.
Response
sourcestringcompletebooleancategoriesobject[]categories[].urlstringcategories[].labelstringcategories[].hierarchy?string[]categories[].category_id?string | nullFields marked ? are optional.
GETCatalog categories by category id products/v1/catalog/categories/{category_id}/products
Browse a source category using the `category_id` and canonical `url` returned by catalog-categories. Page is 1-based and page_size is forwarded to the source. This operation is a caller-invoked collection read and does not retrieve per-product detail.
Input
category_idRequiredPath · stringSource category identifier returned by category discovery.
Example: 10359
urlRequiredQuery · stringCanonical category URL returned by category discovery.
Example: https://www.1800flowers.com/birthday-flowers-10359
pageOptionalQuery · integer, min: 1, default: 11-based source category page.
Example: 1
page_sizeOptionalQuery · integer, min: 1, max: 36, default: 10Products requested from the source category.
Example: 10
Response
pageintegersource?string | nullproductsobject[]products[].id?string | nullproducts[].url?string | nullproducts[].name?string | nullproducts[].brand?string | nullproducts[].sku_ids?string[]products[].brand_id?string | nullproducts[].currency?string | nullproducts[].base_code?string | nullproducts[].source_url?string | nullproducts[].part_number?string | nullproducts[].sale_prices?number[]products[].availabilityobjectproducts[].availability.perishable?boolean | nullproducts[].availability.ship_alone?boolean | nullproducts[].availability.delivery_message?string | nullproducts[].availability.display_end_date?string | nullproducts[].availability.latest_ship_date?string | nullproducts[].availability.delivery_date_type?string | nullproducts[].availability.display_start_date?string | nullproducts[].availability.earliest_ship_date?string | nullproducts[].availability.product_delivery_type?string | nullproducts[].availability.availability_indicator?string | nullproducts[].product_type?string | nullproducts[].delivery_type?string | nullproducts[].retail_prices?number[]products[].sale_price_range?number[]products[].retail_price_range?number[]page_sizeintegercategory_idstringtotal_pages?integer | nullcategory_urlstringtotal_products?integer | nullattribution_token?string | nullFields marked ? are optional.
GETCatalog trending searches/v1/catalog/trending-searches
Return the site's current ranked trending search phrases. Use a returned phrase unchanged as the `query` input to product search. This is a live suggestion list, not a complete taxonomy or an allowlist of all accepted search text.
Input
No input parameters.
Response
sourcestringsearchesobject[]searches[].rank?integer | nullsearches[].phrasestringFields marked ? are optional.
GETProducts detail/v1/products/detail
Retrieve the public structured detail record for a canonical product URL returned by product search. Pass that URL unchanged; the service does not guess slugs or perform hidden per-result enrichment. The response is sourced from the product page's schema.org Product JSON-LD and includes description, image, SKU, offers, currency, and source availability strings when present.
Input
urlRequiredQuery · stringCanonical product URL returned by search.
Example: https://www.1800flowers.com/florist-delivered-long-stem-red-roses-163009
Response
sku?string | nullurlstringname?string | nullbrand?string | nullimages?string[]offersobject[]offers[].sku?string | nulloffers[].url?string | nulloffers[].price?number | nulloffers[].currency?string | nulloffers[].condition?string | nulloffers[].availability?string | nulloffers[].price_valid_until?string | nulldescription?string | nullsource_formatstringFields marked ? are optional.
GETProducts search/v1/products/search
Search public 1-800-Flowers products by free-text query. Query is the source's accepted search term; use a phrase from the trending-searches operation or any other familiar term the site accepts. Pages are 1-based, source totals are returned, and `page_size` is forwarded to the source (observed maximum 36). The source's BEST_SELLERS ordering is independently verified; its browser-exposed price sort values are not accepted because fresh HTTP probes returned the same un-ordered page. Results expose source facets and canonical URLs. Search does not retrieve product detail per result.
Input
queryRequiredQuery · stringFree-text catalog search term.
Example: roses
pageOptionalQuery · integer, min: 1, default: 11-based source result page.
Example: 1
sortOptionalQuery · string, default: BEST_SELLERSThe only source ordering independently verified to affect this public HTTP operation.
Example: BEST_SELLERS
page_sizeOptionalQuery · integer, min: 1, max: 36, default: 36Products requested from the source; the observed source maximum is 36.
Example: 12
Response
pageintegersortstringquerystringfacetsobject[]facets[].name?string | nullfacets[].type?string | nullfacets[].value?string | nullfacets[].entries?object[]facets[].entries[].to?number | nullfacets[].entries[].from?number | nullfacets[].entries[].name?string | nullfacets[].entries[].count?integer | nullfacets[].entries[].value?string | nullfacets[].display_open?boolean | nullproductsobject[]products[].id?string | nullproducts[].url?string | nullproducts[].name?string | nullproducts[].brand?string | nullproducts[].sku_ids?string[]products[].brand_id?string | nullproducts[].currency?string | nullproducts[].base_code?string | nullproducts[].source_url?string | nullproducts[].part_number?string | nullproducts[].sale_prices?number[]products[].availabilityobjectproducts[].availability.perishable?boolean | nullproducts[].availability.ship_alone?boolean | nullproducts[].availability.delivery_message?string | nullproducts[].availability.display_end_date?string | nullproducts[].availability.latest_ship_date?string | nullproducts[].availability.delivery_date_type?string | nullproducts[].availability.display_start_date?string | nullproducts[].availability.earliest_ship_date?string | nullproducts[].availability.product_delivery_type?string | nullproducts[].availability.availability_indicator?string | nullproducts[].product_type?string | nullproducts[].delivery_type?string | nullproducts[].retail_prices?number[]products[].sale_price_range?number[]products[].retail_price_range?number[]page_sizeintegertotal_pages?integer | nullredirect_url?string | nulloriginal_query?string | nulltotal_products?integer | nullshowing_results_for?string | nullcan_show_results_for?boolean | nullFields marked ? are optional.
GETProducts by part number pricing/v1/products/{part_number}/pricing
Return live retail and sale pricing entries for the product part number returned by product search. A part number identifies a catalog product in the current source pricing context; each returned price row may identify a distinct SKU.
Input
part_numberRequiredPath · stringCatalog part number from search results.
Example: 1001-P-163009
Response
brand?string | nullpricesobject[]prices[].type?string | nullprices[].total?number | nullprices[].value?number | nullprices[].display?number | nullprices[].adjustment?number | nullprices[].promo_applied?boolean | nullprices[].display_charges?boolean | nullprices[].sku_part_number?string | nullpart_numberstringproduct_type?string | nullFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.