# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-oms-fromyouflowers-com-api-a4d1c157/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-oms-fromyouflowers-com-api-a4d1c157/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-oms-fromyouflowers-com-api-a4d1c157/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-oms-fromyouflowers-com-api-a4d1c157/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-oms-fromyouflowers-com-api-a4d1c157/get_testimonials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-oms-fromyouflowers-com-api-a4d1c157/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","query":"<string>","results_per_page":"<integer>","sort":"<string>"}'
```