​
Overview

The Refine API enables you to manage product catalogs and deliver product recommendations and search experiences. Built for e-commerce and retail applications, our API provides powerful visual and text-based search capabilities with real-time product management.

​
Base URL

All API requests should be made to: 
https://api.joinrefine.io

​
API Overview

The Refine API is organized around REST principles and uses standard HTTP methods, authentication, and response codes. All responses are returned in JSON format.

​
Core Capabilities

Catalog Management

Create and manage product catalogs for your organization

Product Operations

Add, update, and organize products within your catalogs

Visual Search

Search products using text queries with visual similarity matching

Recommendations

Get AI-powered product recommendations based on visual similarity

​
Getting Started

1

Get your API Key

Generate an API key with Admin permissions from the Refine Dashboard > API keys tab
2

Create a Catalog

Use the Dashboard UI or the API to create a product catalog
3

Add Products

Upload products with images and metadata to your catalog
4

Start Searching

Use our Search and Recommendations APIs to power your product discovery

​
SDKs & Tools

JavaScript SDK

Coming Soon! We’re actively developing our JavaScript SDK to make integration even easier.

​
Need Help?

Support

Contact our support team for assistance