# Tiffany Scraper - Luxury Jewelry (`aboo.script/tiffany-scraper`) Actor

Scrape Tiffany & Co. jewelry, watches and gifts from the official store in any country: prices, materials, gemstones, variants, sizes with availability, SKUs, descriptions and images.

- **URL**: https://apify.com/aboo.script/tiffany-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Tiffany Scraper - Luxury Jewelry

![Tiffany Scraper - Luxury Jewelry](https://i.ibb.co/bjL52xRG/tiffany-banner.png)

**Tiffany Scraper** extracts Tiffany & Co. jewelry, watches, home accessories and gifts from the official [Tiffany & Co.](https://www.tiffany.com/) online store into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a category, collection or product URL from any Tiffany country store, and get the name, collection, local price and currency, stock status, material, gemstone, variants, sizes with availability, SKUs, description and images for every product. No account or login required.

### Introduction

[Tiffany & Co.](https://www.tiffany.com/) is one of the world's best-known luxury jewelers, founded in New York in 1837 and famous for its engagement rings, the Tiffany T and HardWear collections, and the Tiffany Blue Box. Its official online store runs in many countries, each with its own prices, currency and product range.

This actor collects the same public information you see in your browser and turns it into a ready-to-use Tiffany data feed. You can run it once, schedule it to run daily to follow prices and stock, or connect it to your own tools. It works as a simple Tiffany API alternative and handles the store's Akamai protection for you.

### What data can you extract from Tiffany & Co.?

- 🏷️ Product name, full name, collection, brand, product ID, style group and style number
- 🗂️ Category, subcategory and breadcrumbs
- 💲 Price as a number, price as shown on the site, currency, and whether the price is hidden on request
- 📦 Availability (In Stock, Out Of Stock, Back Order, Limited Availability, In Store Only), in-stock flag and back-order flag
- 💎 Material, gemstone and designer
- 🎨 Every variant option (material, color, gemstone, scale, carat weight, diamond color and clarity, and more) with selected and available flags
- 📏 Sizes with availability, plus a simple list of sizes you can order
- 📝 Product details, description, engraving and return options
- 🔢 SKUs with country of origin
- 🖼️ Main image and all product images
- 🌍 Country and store language of each result, and a direct URL to every product

### Use Cases

- 📈 **Market research**: compare Tiffany prices across categories, collections and countries, and see how the range is priced in each currency.
- 🕵️ **Competitor monitoring**: follow new launches, price changes and sold-out pieces from one of the leading luxury jewelers.
- 💱 **Price comparison across countries**: scrape the same category in the US, UK, France or Korea and compare local prices.
- 🗂️ **Database building**: build your own searchable catalog of Tiffany & Co. jewelry with materials, gemstones and images.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Tiffany & Co. step by step

1. Paste one or more Tiffany & Co. category, collection or product URLs into **Start URLs**.
2. Set **Maximum number of results** to how many products you want per URL.
3. Click **Start** and wait for the run to finish.
4. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Tiffany & Co. URLs to scrape. Supported pages: category pages (for example `https://www.tiffany.com/jewelry/rings/`), collection pages (for example `https://www.tiffany.com/designers-collections/tiffany-t/`), filter pages that have their own address (for example `https://www.tiffany.com/jewelry/rose-gold/`), and single product pages. The country, currency and language follow the store in the URL, such as tiffany.com, tiffany.co.uk, tiffany.fr, tiffany.de or tiffany.kr. A URL with `?page=3` starts from that page.
- **Maximum number of results**: how many products to collect for each start URL. Set 0 for no limit.

### Input Examples

Scrape the Tiffany jewelry category in the US store:

```json
{
  "startUrls": [{ "url": "https://www.tiffany.com/jewelry/" }],
  "maxResults": 5
}
```

### Output

Each product is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://www.tiffany.com/jewelry/bracelets/tiffany-t-18k-yellow-gold-bracelets-1366369752.html",
  "productId": "60010764",
  "styleGroupId": "M10271",
  "styleNumber": "136-63-69752",
  "name": "Narrow Wire Bracelet in Yellow Gold",
  "collection": "Tiffany T",
  "fullName": "Tiffany T Narrow Wire Bracelet in Yellow Gold",
  "brand": "Tiffany & Co.",
  "category": "Jewelry",
  "subcategory": "Bracelets",
  "breadcrumbs": ["Jewelry", "Bracelets"],
  "price": 2500,
  "priceText": "$2,500",
  "currency": "USD",
  "priceHidden": false,
  "availability": "In Stock",
  "inStock": true,
  "backOrder": false,
  "material": "18k Yellow Gold",
  "gemstone": null,
  "designer": null,
  "engravingAvailable": false,
  "returnable": true,
  "sizes": [
    { "size": "Small", "selected": false, "available": true },
    { "size": "Medium", "selected": true, "available": true },
    { "size": "Large", "selected": false, "available": true }
  ],
  "availableSizes": ["Small", "Medium", "Large"],
  "variants": [
    { "attribute": "Material", "value": "18k Rose Gold", "selected": false, "available": true },
    { "attribute": "Material", "value": "18k White Gold", "selected": false, "available": true },
    { "attribute": "Material", "value": "18k Yellow Gold", "selected": true, "available": true },
    { "attribute": "Color", "value": "Rose Gold", "selected": false, "available": true },
    { "attribute": "Color", "value": "Yellow Gold", "selected": true, "available": true }
  ],
  "details": ["18k gold", "Motif, narrow", "Size medium", "Fits wrists up to 6.25\""],
  "skus": [
    { "sku": "33263511", "countryOfOrigin": "Italy" },
    { "sku": "33419104", "countryOfOrigin": null }
  ],
  "description": "Tiffany T is an expression of love’s endless potential. Inspired by an archival bracelet from 1975, T is an homage to the House’s iconic motif...",
  "mainImage": "https://media.tiffany.com/is/image/tco/60010764_BLT_MAIN1X1",
  "images": [
    "https://media.tiffany.com/is/image/tco/60010764_BLT_MAIN1X1",
    "https://media.tiffany.com/is/image/tco/60010764_BLT_SIO2X1"
  ],
  "country": "US",
  "locale": "en_US",
  "scrapedAt": "2026-10-26T07:27:03.647Z"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Keyword search is not supported yet: Tiffany search result pages (`/search/?q=...`) are skipped. Use a category, collection or filter page instead.
- Filters and sort orders that you pick on a category page without the address changing are not kept. Filter pages with their own address (such as Rose Gold Jewelry) work as start URLs.
- Homepages and editorial pages (such as High Jewelry stories) are not product lists and are skipped.
- Some high-end pieces show "Price upon request" on the website. For those, `price` and `priceText` are `null` and `priceHidden` is `true`.
- Texts such as names, details and descriptions are in the language of the store you scrape, for example French on tiffany.fr.
- Products without sizes return an empty `sizes` list, and `gemstone` or `designer` are `null` when the piece has none.

### Why use the Tiffany Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **Every country store**: paste a URL from any Tiffany store and get local prices and currency.
- 🎯 **Full variant data**: all materials, colors, gemstones and sizes with availability, not just the selected one.
- 🧹 **Clean data**: prices are real numbers, availability is readable, and text is free of HTML.
- 💸 **Pay for what you need**: set a result limit per URL and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going through the pages until it reaches your limit or the end of the category.

#### Do I need a Tiffany account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Which countries are supported?

Any Tiffany & Co. country store with the same online catalog, such as the United States, United Kingdom, France, Germany, Italy, Spain and South Korea. Just paste a category or product URL from that store.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh prices and stock automatically.

#### Why are some fields empty?

Some products simply do not show every piece of information. When a field is not available on the website, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs. If you need other inputs, such as keyword search or price filters, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Tiffany & Co.](https://www.tiffany.com/)

# Actor input Schema

## `startUrls` (type: `array`):

Tiffany & Co. category, collection or filter pages (for example https://www.tiffany.com/jewelry/rings/ or https://www.tiffany.com/jewelry/rose-gold/) and product pages. The country, currency and language follow the store domain of the URL, for example tiffany.com, tiffany.co.uk or tiffany.fr.

## `maxResults` (type: `integer`):

Maximum number of products to scrape per start URL. Set 0 for no limit.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.tiffany.com/jewelry/"
    }
  ],
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.tiffany.com/jewelry/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/tiffany-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.tiffany.com/jewelry/" }] }

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/tiffany-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.tiffany.com/jewelry/"
    }
  ]
}' |
apify call aboo.script/tiffany-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/tiffany-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0rstyVIRe75CIQNMp/builds/hVSaOasl8wvqbpMxT/openapi.json
