Public and Paid Datasets

The Furnilytics API provides structured access to curated datasets covering macroeconomics, retail performance, trade flows, pricing, and furniture market indicators.

We offer two dataset tiers:

Public datasets

Public datasets are freely accessible and power the interactive market indicator pages on furnilytics.com.
They are intended for exploration, research, and demonstration.

Pro datasets

The majority of Furnilytics datasets are Pro datasets.
These provide full coverage, higher frequency updates, extended historical depth, and broader country scope.

Pro datasets require an API key.

For more information about the API, please check out our services page.

The official Python client is the easiest way to work with the Furnilytics API.
It handles authentication, error management, and returns datasets as Pandas DataFrames.

Install

pip install furnilytics

Using Public Datasets (No API Key Required)

Public datasets can be accessed without authentication. More extensive examples can be found in our Github repository.

from furnilytics import Client

# Set client without API key
cli = Client()

# Check API health
print(cli.health())

# Browse available datasets
datasets = cli.datasets()
print(datasets.head())

# Load a public dataset
df = cli.data("retail/online/web_search_trends_eu", limit=12)

print(df.head())

Public datasets are the same structured datasets used in our public market indicator pages.

Using Pro Datasets (API Key Required)

Most Furnilytics datasets are part of the Pro tier.

To access Pro datasets, provide your API key. You don't have an API key yet? Email support@furnilytics.com

export FURNILYTICS_API_KEY="your_api_key"

Then:

from furnilytics import Client

cli = Client()  # automatically reads FURNILYTICS_API_KEY

df = cli.data("other/machinery/eumabois_export_na")
print(df.head())

Option 2 — Pass key directly

from furnilytics import Client

cli = Client(api_key="your_api_key")

df = cli.data("macro_economics/production/eu_furniture_ipi")
print(df.head())

If a Pro dataset is requested without a valid API key, an authorization error is returned.

For API access and pricing information:
support@furnilytics.com

Optional: Direct HTTP Access

While we recommend using the Python client, the API can also be accessed directly via HTTPS.

Base URL

https://furnilytics-api.fly.dev

Core Endpoints

Dataset catalog

GET /datasets

Metadata (all datasets)

GET /metadata

Metadata (single dataset)

GET /metadata/{id}

Data retrieval

GET /data/{id}

Dataset IDs follow:

topic/subtopic/table_id

Example:

macro_economics/prices/eu_hicp_energy

Pro Authentication (HTTP)

Provide your API key in the request header:

X-API-Key: your_api_key

Example:

curl -H "X-API-Key: YOUR_API_KEY" \
"https://furnilytics-api.fly.dev/data/trade/exports/eu_furniture_exports?limit=12"

Contact

Questions or dataset requests? Email support@furnilytics.com or open an issue on our repo.

Terms of Use

Access to and usage of the Furnilytics API and its datasets are governed by Furnilytics Terms of Service.

Redistribution, mirroring, or commercial resale of raw datasets is not permitted without written authorisation.