# Oms Fromyouflowers — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse From You Flowers' complete product catalog, view detailed information about floral arrangements and gifts, explore available categories, and read customer testimonials to help with your purchase decisions. Get autocomplete suggestions as you search and access all the product details you need to find the perfect flowers or gift.

**Category:** E-commerce | **Website:** [oms.fromyouflowers.com/](https://oms.fromyouflowers.com/) | **Docs:** [parse.bot/marketplace/a4d1c157-7f39-4e3c-abb2-195da1ce4aa7/oms-fromyouflowers-com-api](https://parse.bot/marketplace/a4d1c157-7f39-4e3c-abb2-195da1ce4aa7/oms-fromyouflowers-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get categories

Get available product categories from the site's catalog via Searchspring facets, including product counts per category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product details

Extract detailed product information from a specific product page, including all available size options (Regular, Deluxe, Premium), prices, add-ons (balloons, chocolates, teddy bears), and alternative images. The url_slug is the path segment from product URLs returned by search_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_slug` | string | Yes | Product URL slug from the product page URL, as found in search_products results[*].url. Example: 'lily--rose-celebration' from /products/lily--rose-celebration.htm |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url_slug":"<string>"}'
```

### Get search suggestions

Get search suggestions and product matches for a partial query via the Searchspring autocomplete API. Returns matching products with pagination metadata and facets in native format.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search query to get suggestions for (e.g., 'tul' for tulips, 'ros' for roses). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/get-search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get testimonials

Fetch customer testimonials with ratings, review text, author info, and product references. Returns paginated results with 30 records per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/get-testimonials \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search products

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by category name as returned by get_categories (e.g., 'Birthday', 'Roses', 'Sympathy', 'Love and Romance', 'Gift Baskets'). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search query term (e.g., 'roses', 'tulips', 'birthday'). If omitted and no category specified, returns all products. |
| `results_per_page` | integer | No | Number of results per page. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/oms-fromyouflowers/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","query":"<string>","results_per_page":"<integer>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.