Preparing feed for LupaSearch Demo

Use this guide to prepare a feed for LupaSearch Demo. Your feed should represent your catalog well enough to demonstrate LupaSearch capabilities.

General Guidelines

• Include an id field for every item. It is required for indexing and must be unique across the feed. The value can be a string or number.
• Include the fields relevant to your content, such as title, description, price, availability, category, and brand.
• Include an image URL when possible, either relative or absolute. Images make products easier to identify in the demo and enable image vector search.
• To demonstrate filtering and faceting, include filterable attributes such as color, size, or material. A shared prefix, such as attribute_color and attribute_size, makes related attributes easier to identify and map consistently.
• Keep fields flat where possible. Avoid nested structures to simplify field mapping in LupaSearch.
• String fields can contain one value or an array of values. For example, use ["red", "blue"] when a product has multiple colors.

Feeds can be provided in .json or .xml format. The examples below use JSON.

E-shop feed example

This is an example product-feed structure. Adapt the fields and names to fit your catalog. Keep the purpose of each field clear so the LupaSearch team can map it to the appropriate LupaSearch field type.

[
  {
    "id": "1",
    "title": "Product 1",
    "description": "Description of product 1",
    "price": 10.99,
    "regular_price": 12.99,
    "discount_percent": 15,
    "in_stock": true,
    "category_tree": [
      "Category 1 > Subcategory 1 > Subcategory 2",
      "Category 2 > Subcategory 3"
    ],
    "brand": "Brand 1",
    "image_url": "https://example.com/images/product1.jpg",
    "attribute_color": "Red",
    "attribute_size": "M"
  },
  {
    "id": "2",
    "title": "Product 2",
    "description": "Description of product 2",
    "price": 20.99,
    "regular_price": 25.99,
    "discount_percent": 16,
    "in_stock": false,
    "category_tree": [
      "Category 1 > Subcategory 1 > Subcategory 2",
      "Category 3 > Subcategory 4"
    ],
    "brand": "Brand 2",
    "image_url": "https://example.com/images/product2.jpg",
    "attribute_color": "Blue",
    "attribute_size": "L",
    "attribute_material": ["Cotton", "Polyester"]
  }
]

FAQ feed example

Frequently asked questions (FAQs) are a common type of content to index and search with LupaSearch. Adapt the field names and content to your use case.

[
  {
    "id": "1",
    "question": "What is LupaSearch?",
    "answer": "LupaSearch is a powerful search and recommendation engine that helps e-commerce businesses improve their search and discovery capabilities.",
    "category": "General"
  },
  {
    "id": "2",
    "question": "How do I integrate LupaSearch with my e-commerce platform?",
    "answer": "You can integrate LupaSearch with your e-commerce platform by using our API or SDKs. Please refer to our documentation for detailed instructions.",
    "category": "Integration"
  }
]

News, content, or blog feed example

Any text-based content can be indexed and searched with LupaSearch. This example shows a feed for news, content, or blog articles. Adapt the field names and content to your use case.

[
  {
    "id": "1",
    "title": "LupaSearch Launches New Features",
    "content": "We are excited to announce the launch of new features in LupaSearch that will enhance the search and recommendation capabilities for our users.",
    "author": "John Doe",
    "published_date": "2026-01-01",
    "category": "Announcements"
  },
  {
    "id": "2",
    "title": "How to Optimize Your E-commerce Search",
    "content": "In this article, we will discuss best practices for optimizing your e-commerce search experience using LupaSearch.",
    "author": "Jane Smith",
    "published_date": "2026-02-15",
    "category": "Guides"
  }
]