# Recombee Documentation > Recombee is a Recommender as a Service with easy integration and powerful Admin UI. This documentation covers integration, API reference, SDKs, and scenario recipes. > For an API specification, see [/api.md](/api.md). For an OpenAPI spec, see [/openapi.yaml](/openapi.yaml). ## Learn - [Introduction](https://docs.recombee.com/index.md): Recombee is a recommendation engine with easy integration and powerful Admin UI. Our service has multiple use cases (e.g. in media, e-commerce). - [Getting Started](https://docs.recombee.com/getting_started.md): Read our guide with integration examples and start with the integration of Recombee's engine today. - [Concepts & Glossary](https://docs.recombee.com/concepts-and-glossary.md): Basic terminology that is used across the documentation. ## Integrate - [Getting Started](https://docs.recombee.com/getting_started.md): Read our guide with integration examples and start with the integration of Recombee's engine today. ### API Clients (SDKs) - [API Clients (SDKs)](https://docs.recombee.com/api_clients.md): We provide clients with libraries in multiple programming languages (e.g. JavaScript, Java, Python, Ruby) that make integration of recommendation engine into web or app easy. - Client-side SDKs - [JavaScript API Client](https://docs.recombee.com/js_client.md): JavaScript API Documentation - [Kotlin API Client](https://docs.recombee.com/kotlin_client.md): Kotlin API Documentation - [Swift API Client](https://docs.recombee.com/swift_client.md): Swift API Documentation - Server-side SDKs - [Node.js](https://github.com/recombee/node-api-client) - [Python](https://github.com/recombee/python-api-client) - [PHP](https://github.com/recombee/php-api-client) - [Ruby](https://github.com/recombee/ruby-api-client) - [Java](https://github.com/recombee/java-api-client) - [.NET](https://github.com/recombee/net-api-client) - [Go](https://github.com/recombee/go-api-client) ### Widget SDKs - [Widget SDKs](https://docs.recombee.com/widget-sdks.md) - Carousel Widget - [Carousel Widget (JS)](https://docs.recombee.com/widget-sdks/carousel-widget-js.md) - [Carousel Widget (React)](https://docs.recombee.com/widget-sdks/carousel-widget-react.md) - Feed Widget - [Feed Widget (JS)](https://docs.recombee.com/widget-sdks/feed-widget-js.md) - [Feed Widget (React)](https://docs.recombee.com/widget-sdks/feed-widget-react.md) - Grid Widget - [Grid Widget (JS)](https://docs.recombee.com/widget-sdks/grid-widget-js.md) - [Grid Widget (React)](https://docs.recombee.com/widget-sdks/grid-widget-react.md) - Quick Search Widget - [Quick Search Widget (JS)](https://docs.recombee.com/widget-sdks/quick-search-widget-js.md) - [Quick Search Widget (React)](https://docs.recombee.com/widget-sdks/quick-search-widget-react.md) ### No-Code Widgets - [No-Code Widgets](https://docs.recombee.com/no-code-widgets.md) ### Catalog Feeds - [Catalog Feeds](https://docs.recombee.com/catalog_feeds.md): Setting a catalog feed in the Recombee Admin UI is an alternative to uploading the items catalog using our API. - [Google Merchant Feed](https://docs.recombee.com/catalog_feeds/google-merchant-feed.md): Synchronize items from a Google Merchant feed in XML, TSV or CSV, and recommend only the items that are in stock. - [Atom / RSS Feed](https://docs.recombee.com/catalog_feeds/atom-rss-feed.md): Synchronize articles, blog posts or podcast episodes from an Atom or RSS feed, picking which of the recognized properties to import. - [Custom XML Feed](https://docs.recombee.com/catalog_feeds/custom-xml-feed.md): Synchronize items from any XML file by setting the XPath to the item records, their IDs and their properties. - [Custom JSON Feed](https://docs.recombee.com/catalog_feeds/custom-json-feed.md): Synchronize items from any JSON file by setting the path of keys to the item records, their IDs and their properties. - [Custom CSV Feed](https://docs.recombee.com/catalog_feeds/custom-csv-feed.md): Synchronize items from a CSV file with one item per line, a header row and the item IDs in the first column. - [Heureka XML Feed](https://docs.recombee.com/catalog_feeds/heureka-xml-feed.md): Synchronize items from a Heureka XML feed, and recommend only the items that are available. ### Third Party Integrations - [Third-Party Integrations](https://docs.recombee.com/third-party-integrations.md): Recombee offers multiple integrations with third-party services, which make it easier to add recommendations to your website or app. - [Segment Integration](https://docs.recombee.com/segment.md) - [Keboola Integration](https://docs.recombee.com/keboola.md): Upload catalog and interactions from CSV into Recombee via Keboola Writer. - [Shoptet GTM Integration](https://docs.recombee.com/shoptet_gtm_integration.md): Manual for Recombee GTM integration on Shoptet e-commerce web sites. ### Guides - [Integration Tips](https://docs.recombee.com/integration_tips.md) - [Tutorial](https://docs.recombee.com/tutorial.md): Learn how to set up sending of interactions and upload items catalog to Recombee and receive recommendations based on them. - [Integration Guide for AI Assistants](https://docs.recombee.com/ai_assistant_guide.md): An operational field manual for AI coding assistants and agents integrating an application with Recombee — authentication, catalog sync, interactions, recommendations, and common pitfalls. ## Configure - [Configure](https://docs.recombee.com/configure.md): Set up Recombee to fit your vision and business needs. ### Admin UI - [Admin UI](https://docs.recombee.com/admin_ui.md): Recombee Admin UI is available at admin.recombee.com. On registration an Organization is created for your company. - [Third Party Login / SSO](https://docs.recombee.com/third_party_login_sso.md): Manual for enabling third party authentication to Recombee. ### Scenarios - [Scenarios](https://docs.recombee.com/scenarios.md): A Scenario defines a specific application of recommendations on your website, mobile app, or email campaign. You can configure distinct behavior for each scenario. - [Scenario Settings in the Admin UI](https://docs.recombee.com/scenarios/settings-in-admin-ui.md): Customize each scenario in the Admin UI with its Logic, Filters, Boosters and Constraints. - [Composite Recommendations](https://docs.recombee.com/scenarios/composite-recommendations.md): Composite Recommendations return both a source entity (e.g., an Item or Item Segment) and a related list of recommendations in a single response. - [A/B Testing](https://docs.recombee.com/ab-testing.md): A/B Testing lets you compare different recommendation configurations within a Scenario and measure their effect on your key metrics. ### Item Segmentations - [Item Segmentations](https://docs.recombee.com/segmentations.md) - [Property-Based Segmentation](https://docs.recombee.com/segmentations/property-based-segmentations.md): Group the Items into Segments by the value of a property, in the Admin UI or via the API. - [ReQL Segmentations](https://docs.recombee.com/segmentations/reql-segmentations.md): Define Segments with ReQL - list them one by one with Manual ReQL Segmentation, or derive them from each Item with Auto ReQL Segmentation. - [Recommending Segments](https://docs.recombee.com/segmentations/recommending-segments.md): Recommend or search Item Segments through a Scenario that uses the Segmentation, and filter or boost them with ReQL. ### Logics - [Recommendation Logics](https://docs.recombee.com/logics.md): While Recombee is generally a domain-independent recommendation engine and the default model is optimized to work well in most cases, we have used our experience in some frequent domains to setup some tuned models, and you can now easily pick the logic that is tailored for the particular case. - [Universal Models](https://docs.recombee.com/logics/universal.md): Universal Recombee models for the most common use-cases, applicable to any domain. - [Search](https://docs.recombee.com/logics/search.md): Logics for both personalized and non-personalized full-text search. - [E-commerce](https://docs.recombee.com/logics/e-commerce.md): Logics tuned for e-commerce, including homepages, product detail, cart and category pages. - [Video](https://docs.recombee.com/logics/video.md): Fine-tuned logics for VOD and similar video services, including continue watching, watch next and homepage rows. - [News](https://docs.recombee.com/logics/news.md): Fine-tuned logics for news and publishing, including read next, homepage feeds and editors picks. - [Classified Advertising](https://docs.recombee.com/logics/classified-advertising.md): Logics tailored for classified advertising, such as real estate, automotive and similar listings. ### ReQL - [Introduction to ReQL](https://docs.recombee.com/reql.md): Recombee Query Language (ReQL) provides an elegant way of applying business rules or any other rules to the recommendations. - [Filtering and Boosting](https://docs.recombee.com/reql_filtering_and_boosting.md): In filtering, the expression must return boolean value for each item. In advanced applications, you may wish to boost the recommendation rates of some items. - [Value Types and Operators](https://docs.recombee.com/reql/value-types-and-operators.md): The value types ReQL works with - numbers, strings, sets and arrays - and the comparison, containment, logical and conditional operators that apply to them. - ReQL Functions - [ReQL Functions](https://docs.recombee.com/reql/functions.md): Functions may be used to enhance your ReQL queries – for example upsell or getting nearby items can be achieved easily by functions. - [Context](https://docs.recombee.com/reql/functions/context.md): Retrieve properties of the item or user the recommendations are for, or of the Segment they are based on. - [Miscellaneous](https://docs.recombee.com/reql/functions/miscellaneous.md): The current timestamp, a random number, the size of a set or string, an item’s property values, and reducing a set to a single value. - [Lambda](https://docs.recombee.com/reql/functions/lambda.md): Evaluate a lambda expression on every element of a set. - [Type Conversion](https://docs.recombee.com/reql/functions/type-conversion.md): Convert a value to a boolean, a number, a string or a timestamp, including between dates in a text representation and timestamps. - [Math](https://docs.recombee.com/reql/functions/math.md): Maximum, minimum, average, rounding, absolute value, square root, power and logarithm. - [String](https://docs.recombee.com/reql/functions/string.md): Convert letter case and split a string into sub-strings using a separator. - [Interactions Listing](https://docs.recombee.com/reql/functions/interactions-listing.md): List the interactions of a particular user, optionally narrowed to given interaction types. - [Interactions Statistics](https://docs.recombee.com/reql/functions/interactions-statistics.md): The number of bookmarks, detail views, purchases or ratings of an item. - [Item Segments Handling](https://docs.recombee.com/reql/functions/item-segments.md): The items in a Segment, and the Item Segments an item belongs to. - [Geographical](https://docs.recombee.com/reql/functions/geographical.md): Orthodromic distance between two points, geographical polygons and radii, and testing a point for containment in them. ### Recipes - [Recipes](https://docs.recombee.com/recipes.md): Discover how to personalize various use cases within your platform, website, or app. - Video - [Video Recipes](https://docs.recombee.com/recipes/video.md) - Fully Personalized Homepage - [“Recommended For You” Rows](https://docs.recombee.com/recipes/video/fully-personalized-homepage/recommended-for-you-rows.md) - [Personalized Re-ordering of Rows](https://docs.recombee.com/recipes/video/fully-personalized-homepage/personalized-re-ordering-of-rows-advanced.md) - [Editors’ Picks For You](https://docs.recombee.com/recipes/video/fully-personalized-homepage/editors-picks-for-you.md) - [Continue Watching](https://docs.recombee.com/recipes/video/fully-personalized-homepage/continue-watching.md) - [Popular & Trending](https://docs.recombee.com/recipes/video/fully-personalized-homepage/popular-and-trending.md) - [Because You Watched](https://docs.recombee.com/recipes/video/fully-personalized-homepage/because-you-watched.md): Learn how to create a "Because You Watched" row that recommends similar titles to what your users recently watched. - [Actors For You](https://docs.recombee.com/recipes/video/fully-personalized-homepage/actors-for-you.md) - [Short Videos Feed](https://docs.recombee.com/recipes/video/feed/swiping-feed.md) - Asset Detail & Player - [More Like This](https://docs.recombee.com/recipes/video/asset-detail-and-player/more-like-this.md) - [Watch Next](https://docs.recombee.com/recipes/video/asset-detail-and-player/watch-next.md) - [Search Movies/Series](https://docs.recombee.com/recipes/video/search-movies-and-series.md) - [Personalized Emailing](https://docs.recombee.com/recipes/video/personalized-emailing.md) - E-commerce - [E-Commerce Recipes](https://docs.recombee.com/recipes/e-commerce.md) - Fully Personalized Homepage - ["For You" Sections](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/for-you-sections.md): Guide to set up and optimize 'Recommended For You' rows for E-Commerce using Recombee. - [Personalized Re-ordering of Sections](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/personalized-re-ordering-of-sections-advanced.md): Learn how to personalize the order of homepage sections and the products within them using Recombee. - [Bestsellers](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/bestsellers.md): Guide to set up and optimize 'Bestsellers' rows for E-Commerce using Recombee. - [Recently Viewed](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/recently-viewed.md): Guide to set up and optimize 'Recently Viewed' rows for E-Commerce using Recombee. - [Because You Purchased](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/because-you-purchased.md): Learn how to create a "Because You Purchased" row that recommends complementary products to what your users previously purchased. - [Brands For You](https://docs.recombee.com/recipes/e-commerce/fully-personalized-homepage/brands-for-you.md) - Product Detail - [Alternative Products & Upsell](https://docs.recombee.com/recipes/e-commerce/product-detail/alternative-products-and-upsell.md) - [Bought Together & Accessories](https://docs.recombee.com/recipes/e-commerce/product-detail/bought-together-and-accessories.md) - [Cart](https://docs.recombee.com/recipes/e-commerce/cart.md) - [Category Page](https://docs.recombee.com/recipes/e-commerce/category/reordering-of-category-products.md) - [Personalized Emailing](https://docs.recombee.com/recipes/e-commerce/personalized-emailing.md) - Search - [Quick Search](https://docs.recombee.com/recipes/e-commerce/search/quick-search.md) - [Faceted Search](https://docs.recombee.com/recipes/e-commerce/search/faceted-search.md) - News & Articles - [News Recipes](https://docs.recombee.com/recipes/news.md) - Homepage - [Top Stories](https://docs.recombee.com/recipes/news/homepage/top-stories.md): Learn how to configure a Top Stories scenario for news platforms using Recombee, combining trending news, personalized content, and editorial picks. - [Personalized Sections With Reordering](https://docs.recombee.com/recipes/news/homepage/personalized-sections-with-reordering.md): Learn how to personalize the order of homepage sections and the articles within them using Recombee. - [Cross-Site Recommendations on Homepage](https://docs.recombee.com/recipes/news/homepage/cross-site-recommendations.md): Learn how to set up personalized cross-site recommendations on your news homepage using Recombee. - [Latest News](https://docs.recombee.com/recipes/news/homepage/latest-news.md): Learn how to configure a Latest News scenario with Recombee to surface the most recently published articles on your platform. - [Personalized News Feed](https://docs.recombee.com/recipes/news/homepage/personalized-feed.md): Learn how to set up a Personalized News Feed for your news platform with Recombee, offering infinite scroll functionality and tailored content recommendations. - [Personalized Editors’ Picks](https://docs.recombee.com/recipes/news/homepage/personalized-editors-picks.md): Learn how to configure a personalized Editors’ Picks section for news platforms with Recombee, blending editorial curation with personalization. - Article Page - [Read-Next Recommendations](https://docs.recombee.com/recipes/news/article/read-next.md): Learn how to set up Read-Next recommendations for your news platform with Recombee, delivering relevant articles to keep users engaged after reading. - [Cross-Site Recommendations on Article Page](https://docs.recombee.com/recipes/news/article/cross-site-recommendations.md): Learn how to set up cross-site recommendations for your news platform with Recombee, offering personalized article suggestions from different sites. - [Search Articles](https://docs.recombee.com/recipes/news/search-articles.md) - [Personalized Emailing](https://docs.recombee.com/recipes/news/personalized-emailing.md): Learn how to send personalized news emails using Recombee — combining user preferences with unread, timely content for impactful newsletters. ## Measure & Optimize ### Insights - [Insights](https://docs.recombee.com/insights.md): Insights allow you to take a deep dive into your data. - [Library of Predefined Insights](https://docs.recombee.com/insights/library-of-predefined-insights.md): A library of predefined Insights covering frequently used analytical data views, grouped into performance metrics, top items, category-based and item-segment based metrics. - [Creating Custom Insights](https://docs.recombee.com/insights/creating-custom-insights.md): Build a custom Insight from Data Sources, Filters and Splits, and choose how it is visualized. ### A/B Testing - [A/B Testing](https://docs.recombee.com/ab-testing.md): A/B Testing lets you compare different recommendation configurations within a Scenario and measure their effect on your key metrics. ## API Reference - [API Reference](https://docs.recombee.com/api.md): Explore all available API endpoints, that allow you to manage item catalog, users, their interactions, and get recommendations. - [Authentication (HMAC)](https://docs.recombee.com/authentication.md): HMAC-based authentication is the single preferred way of authentication to Recombee APIs. - [Regions](https://docs.recombee.com/regions.md) ### Items - [Items](https://docs.recombee.com/api/items.md): Methods for maintaining the set of items in your catalog: adding, deleting and listing items. ### Item Properties - [Item Properties](https://docs.recombee.com/api/item-properties.md): Methods for defining item properties and setting their values for the items in your catalog. ### Users - [Users](https://docs.recombee.com/api/users.md): Methods for managing the users in your database: adding, deleting, merging and listing users. ### User Properties - [User Properties](https://docs.recombee.com/api/user-properties.md): Methods for defining user properties and setting their values for the users in your database. ### User-Item Interactions - [User-Item Interactions](https://docs.recombee.com/api/interactions.md): Methods for adding, deleting and listing interactions between users and items: detail views, purchases, ratings, cart additions, bookmarks and view portions. ### Recommendations - [Recommendations](https://docs.recombee.com/api/recommendations.md): Methods for recommending items, item segments and users, including composite recommendations. ### Search - [Search](https://docs.recombee.com/api/search.md): Full-text personalized search over items and item segments, and the synonyms that widen it. ### Series - [Series](https://docs.recombee.com/api/series.md): Methods for organizing catalog items into series, expressing an explicit, known ordering of items. ### Segmentations Definition - [Segmentations Definition](https://docs.recombee.com/api/segmentations.md): Methods for grouping items into segments: property-based, manual ReQL and auto ReQL segmentations. ### Miscellaneous - [Miscellaneous](https://docs.recombee.com/api/miscellaneous.md): Batch processing of several requests in one call, listing the scenarios in a database, and resetting a database. ## Optional ### Additional Pages - [Property Roles](https://docs.recombee.com/api/property_roles_metadata.md): A reference of available property roles that can be assigned to item properties, helping the recommendation engine understand the meaning of your data. - [Shoptet Integration](https://docs.recombee.com/shoptet_integration.md): Manual for Recombee integration on Shoptet e-commerce web sites. - [Date and Time Specifiers](https://docs.recombee.com/time_specifiers.md)