# Freedome Products API

> Freedome catalogue: outdoor experiences and stays in Italy, with prices, stock and categories

- Vendor: `freedomeproductsapi` · version 1.0 · category Travel · tags freedome api, freedome products api, woocommerce products api, product catalog api, product prices api, ecommerce product data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/freedomeproductsapi
- This document: https://apiclay.com/docs/freedomeproductsapi.md
- OpenAPI 3.1: https://apiclay.com/api/freedomeproductsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `freedomeproductsapi`
- Updated: 2026-11-18

## About

## Freedome Products API

Freedome's store runs on WooCommerce, and its public Store API serves the catalogue (outdoor experiences and stays in Italy): products with name, SKU, prices, sale flag, stock status, images, categories, tags, attributes and ratings, searchable and sortable; any single product by id; and the product categories with counts.

Data comes from **freedome.it** (https://freedome.it). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/categories` for ids, then `/products?category=&amp;per_page=20` and `/product?id=`.

### Routes

#### GET `/products` - Products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search | query | string | no | Keyword. |
| category | query | string | no | Category id from `/categories`. |
| per_page | query | number | no | Up to 100 (default 10). |
| page | query | number | no | Page. |
| orderby | query | string | no | `date`, `price`, `popularity`, `rating` or `title`. |
| order | query | string | no | `asc` or `desc`. |

Returns: array of `id`, `name`, `slug`, `permalink`, `sku`, `short_description`, `description`, `on_sale`, `prices` (`price`, `regular_price`, `sale_price` in minor units such as cents, `currency_code`, `currency_minor_unit`), `images`, `categories`, `tags`, `attributes`, `is_in_stock`, `average_rating`, `review_count`.

#### GET `/product` - Product
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | number | yes | Product `id` from `/products`. |

Returns: one product with the same fields.

#### GET `/categories` - Categories
No parameters.

Returns: array of `id`, `name`, `slug`, `description`, `parent`, `count`, `image`, `permalink`.

### Caveats

- Prices come as strings in minor units; divide by 10^`currency_minor_unit`. Product text and images belong to Freedome.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by freedome.it.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /products — Products
- Gateway: `GET https://api.apiclay.com/v1/api/freedomeproductsapi/products`
- Public query params: `search` (string), `category` (string), `per_page` (number), `page` (number), `orderby` (string), `order` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /product — Product
- Gateway: `GET https://api.apiclay.com/v1/api/freedomeproductsapi/product`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/freedomeproductsapi/categories`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/freedomeproductsapi/products" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
