Catalog / 1-800-Flowers Public Catalog

1-800-Flowers Public Catalog API

1800flowers.com

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.

  • Shopping
  • flowers
  • gifts
  • products
  • pricing
  • catalog
  • search
6 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

View call pricing
cURL · Catalog categories
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

sourcestring
completeboolean
categoriesobject[]
categories[].urlstring
categories[].labelstring
categories[].hierarchy?string[]
categories[].category_id?string | null

Fields 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 · string

Source category identifier returned by category discovery.

Example: 10359

urlRequiredQuery · string

Canonical category URL returned by category discovery.

Example: https://www.1800flowers.com/birthday-flowers-10359

pageOptionalQuery · integer, min: 1, default: 1

1-based source category page.

Example: 1

page_sizeOptionalQuery · integer, min: 1, max: 36, default: 10

Products requested from the source category.

Example: 10

Response

pageinteger
source?string | null
productsobject[]
products[].id?string | null
products[].url?string | null
products[].name?string | null
products[].brand?string | null
products[].sku_ids?string[]
products[].brand_id?string | null
products[].currency?string | null
products[].base_code?string | null
products[].source_url?string | null
products[].part_number?string | null
products[].sale_prices?number[]
products[].availabilityobject
products[].availability.perishable?boolean | null
products[].availability.ship_alone?boolean | null
products[].availability.delivery_message?string | null
products[].availability.display_end_date?string | null
products[].availability.latest_ship_date?string | null
products[].availability.delivery_date_type?string | null
products[].availability.display_start_date?string | null
products[].availability.earliest_ship_date?string | null
products[].availability.product_delivery_type?string | null
products[].availability.availability_indicator?string | null
products[].product_type?string | null
products[].delivery_type?string | null
products[].retail_prices?number[]
products[].sale_price_range?number[]
products[].retail_price_range?number[]
page_sizeinteger
category_idstring
total_pages?integer | null
category_urlstring
total_products?integer | null
attribution_token?string | null

Fields 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 · string

Canonical product URL returned by search.

Example: https://www.1800flowers.com/florist-delivered-long-stem-red-roses-163009

Response

sku?string | null
urlstring
name?string | null
brand?string | null
images?string[]
offersobject[]
offers[].sku?string | null
offers[].url?string | null
offers[].price?number | null
offers[].currency?string | null
offers[].condition?string | null
offers[].availability?string | null
offers[].price_valid_until?string | null
description?string | null
source_formatstring

Fields 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 · string

Catalog part number from search results.

Example: 1001-P-163009

Response

brand?string | null
pricesobject[]
prices[].type?string | null
prices[].total?number | null
prices[].value?number | null
prices[].display?number | null
prices[].adjustment?number | null
prices[].promo_applied?boolean | null
prices[].display_charges?boolean | null
prices[].sku_part_number?string | null
part_numberstring
product_type?string | null

Fields 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.