Skip to content
SmartOptic

What's in the catalogue

These figures are read straight from the database and refresh on their own — not numbers typed into the page.

430,386
SKUs in total
59,862
in current collections
305
brands
82,796
models
275,253
SKUs with photos
324,546
contact lens SKUs

The catalogue also keeps discontinued models — you need them to identify old stock and past collections. Each SKU carries its own status field.

How to get the data

Two routes for different teams: a call from your own system, or a file anyone on staff can open.

REST API

For integrating with your website, inventory system or marketplace listings.

  • Filter by brand, model, type, gender, shape, material and dozens of other fields
  • Cursor pagination — pull the whole catalogue with no gaps and no duplicates
  • Incremental feed: fetch only what changed since your last sync

Excel export

For teams that need a file rather than an integration. No developer required.

  • Pick brands, filters and columns — save the set as a template
  • See how many SKUs the file will contain before you start
  • Large exports are prepared in the background; the link appears in your account

Photography

Product shots on a clean background, ready for a storefront or a marketplace listing.

  • In the API — direct image links on every SKU
  • In exports — a separate archive, foldered by brand and model
  • The archive ships with an index mapping each barcode to its files

What a response looks like

Real data from the catalogue — not a sample from the documentation.

Request

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Response

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

You choose the field set yourself: ask for just the barcode, price and photo link and that is exactly what comes back. The full list of fields is served by /v1/meta, which is the easiest way to build an integration against.

Frequently asked

Does the catalogue include stock levels?

No. The catalogue is reference data: attributes, photos, barcodes and recommended prices. Stock lives in a different system and is not part of this data. We say so up front so expectations do not drift.

Which prices do you provide?

Recommended retail prices — what the brand suggests selling at. Wholesale prices are not shared, neither through the API nor in exports.

Can I use the photos on my own website?

Yes — that is the most common reason people take the catalogue. The API returns direct image links; exports ship an archive of files with an index.

How often is the data updated?

The catalogue grows continuously as data arrives from the brands. The API has a method that returns only what changed since a given date, so there is no need to re-download everything.

How do I pay?

For now we issue an invoice: there is no card checkout on the site yet. When there is, existing customers will not have to change anything.

Are contact lenses included?

Yes, as a separate section: base curve, power, cylinder, axis, addition, pack size and price. There are no photos for lenses in the database — they add little for this product.