> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinrefine.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the Refine API documentation

## 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

<CardGroup cols={2}>
  <Card title="Catalog Management" icon="folder" href="/api-reference/catalog-operations/create-catalog">
    Create and manage product catalogs for your organization
  </Card>

  <Card title="Product Operations" icon="box" href="/api-reference/product-operations/create-products">
    Add, update, and organize products within your catalogs
  </Card>

  <Card title="Visual Search" icon="magnifying-glass" href="/api-reference/search">
    Search products using text queries with visual similarity matching
  </Card>

  <Card title="Recommendations" icon="sparkles" href="/api-reference/recommendations">
    Get AI-powered product recommendations based on visual similarity
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Get your API Key">
    Generate an API key with Admin permissions from the Refine Dashboard > API keys tab
  </Step>

  <Step title="Create a Catalog">
    Use the Dashboard UI or the API to create a product catalog
  </Step>

  <Step title="Add Products">
    Upload products with images and metadata to your catalog
  </Step>

  <Step title="Start Searching">
    Use our Search and Recommendations APIs to power your product discovery
  </Step>
</Steps>

## SDKs & Tools

<Card title="JavaScript SDK" icon="js">
  <Note>
    **Coming Soon!** We're actively developing our JavaScript SDK to make integration even easier.
  </Note>
</Card>

## Need Help?

<CardGroup cols={1}>
  <Card title="Support" icon="message" href="support@joinrefine.io">
    Contact our support team for assistance
  </Card>
</CardGroup>