# Perselio Documentation

> Documentation for Perselio

## Guides: documentation
- [Getting Started](https://docs.perselio.com/docs/home.md)

## Guides: Onboarding
- [Recommendation Onboarding](https://docs.perselio.com/docs/recommendation-onboarding.md)
- [Search Onboarding](https://docs.perselio.com/docs/search-onboarding.md)
- [Shopping Assistant Onboarding](https://docs.perselio.com/docs/shopping-assistant-onboarding.md)
  - [Smartsupp Integration](https://docs.perselio.com/docs/smartsupp-integration.md)
- [Account Registration](https://docs.perselio.com/docs/account-registration.md)
- [Enable Add-to-cart button](https://docs.perselio.com/docs/expose-add-to-cart.md): Enabling Add to cart button in embedded widgets.
- [User Identification](https://docs.perselio.com/docs/user-identification.md)
- [Identifying Products on Your Site](https://docs.perselio.com/docs/product-identification.md)

## Guides: Analytics
- [Data Collector](https://docs.perselio.com/docs/data-collector.md): Analytics data collector JavaScript
- [Cookies](https://docs.perselio.com/docs/cookies.md)
- [Legacy Script Domains](https://docs.perselio.com/docs/legacy-script-domains.md)

## Guides: Data
- [Feeds](https://docs.perselio.com/docs/feeds.md)
  - [Item Feed](https://docs.perselio.com/docs/item-feed.md): Item Feed (Product Catalogue) provides all necessary information about products.
  - [Availability feed](https://docs.perselio.com/docs/availability-feed.md): Availability Feed provides up-to-date information about product availability.
  - [Category Feed](https://docs.perselio.com/docs/category-feed.md): Provide a category feed that defines category records, hierarchy paths, landing page URLs, and icons for Perselio platform.
  - [Brand Feed](https://docs.perselio.com/docs/brand-feed.md): Provide a brand feed so Search can link brand results to landing pages and display brand metadata.
  - [Text Feed](https://docs.perselio.com/docs/text-feed.md): Use text feeds to add blog articles, web page content, and other text-based content to search and shopping assistant use cases.
- [Import Transaction History](https://docs.perselio.com/docs/import-transaction-history.md)

## Guides: Recommendations
- [Integration options](https://docs.perselio.com/docs/reco-integration-options.md): There are three ways to put Perselio on your site: embed our managed widgets, build your own on the JavaScript SDK, or route everything through your backend. They trade integration effort for control…
- [Widgets](https://docs.perselio.com/docs/reco-widgets.md)
- [Anchors](https://docs.perselio.com/docs/recommendation-anchors.md)
- [Bundles](https://docs.perselio.com/docs/recommendation-bundles.md)
- [Custom Design](https://docs.perselio.com/docs/custom-design.md)
- [JavaScript SDK](https://docs.perselio.com/docs/javascript-sdk.md): JavaScript client for calling API integration.
- [API Integration](https://docs.perselio.com/docs/api-integration-1.md)
- [Marking Rendered Recommendations](https://docs.perselio.com/docs/marking-rendered-recommendations.md)

## Guides: Search
- [Search Curation](https://docs.perselio.com/docs/search-curation.md)
- [Frontend Integration (managed)](https://docs.perselio.com/docs/managed-frontend-integration.md)
  - [Search Results Page](https://docs.perselio.com/docs/search-results.md): The Search Results Page (SERP) is a dedicated page used to display results for a given search query.
  - [Autocomplete](https://docs.perselio.com/docs/autocomplete.md): Autocomplete is a real-time search feature that dynamically suggests relevant results while the user is typing a query.
- [API Integration](https://docs.perselio.com/docs/api-integration.md)
  - [Scenarios](https://docs.perselio.com/docs/scenarios.md): Documentation of most common scenarios / search use-cases.
    - [Autocomplete](https://docs.perselio.com/docs/autocomplete-1.md): Allow user to see a quick search results of item catalogue as he types into the main search box
    - [Article autocomplete](https://docs.perselio.com/docs/autocomplete-texts.md): Article search for the autocomplete widget — querying and rendering article results.
    - [Search results](https://docs.perselio.com/docs/serp.md): Full search results page — querying, rendering items, facets, highlights, and filtering.
    - [Suggested categories](https://docs.perselio.com/docs/suggested-categories.md): Help shoppers move from a search query to a relevant category with links or image cards.
  - [Marking Rendered Search Results](https://docs.perselio.com/docs/marking-rendered-search-results.md): The HTML contract that lets the Data Collector measure autocomplete and search results you render yourself.

## Guides: Shopping assistant
- [Overview](https://docs.perselio.com/docs/overview.md)
- [AI Knowledge Base](https://docs.perselio.com/docs/ai-knowledge-base.md)
- [Floating Action Button and Conversation Window](https://docs.perselio.com/docs/floating-action-button.md)
- [Touchpoints (AI Engagement)](https://docs.perselio.com/docs/shopping-assistant-touchpoints.md)

## Guides: Dashboards
- [Analytics Dashboard](https://docs.perselio.com/docs/dashboard.md)
  - [Shopping Assistant Analytics](https://docs.perselio.com/docs/shopping-assistant-analytics.md)
  - [Reco Analytics](https://docs.perselio.com/docs/reco-analytics-dashboard.md)
  - [Search Analytics](https://docs.perselio.com/docs/search-analytics.md)

## Guides: AB Testing
- [AB Testing Managed Service](https://docs.perselio.com/docs/ab-testing.md)

## Guides: Console
- [Web Console](https://docs.perselio.com/docs/console.md)

## Guides: Other
- [Team](https://docs.perselio.com/docs/team.md)
- [API Status](https://docs.perselio.com/docs/api-status.md)
- [Public IPs](https://docs.perselio.com/docs/public-ips.md)

## API Reference: Items API
- /item
  - [get](https://docs.perselio.com/reference/getitem.md): Get existing item.
  - [put](https://docs.perselio.com/reference/putitem.md): Insert or replace item.
  - [patch](https://docs.perselio.com/reference/patchitem.md): Apply changes to existing item.
  - [delete](https://docs.perselio.com/reference/deleteitem.md): Delete chosen item from the system.
- /item/batch
  - [patch](https://docs.perselio.com/reference/patchitems.md): Update existing items using batch API.
  - [put](https://docs.perselio.com/reference/putitems.md): Insert or replace items in batch.
  - [delete](https://docs.perselio.com/reference/deleteitems.md): Delete items from platform.
- /item/schema
  - [get](https://docs.perselio.com/reference/getschema.md): Retrieves current item schema.
  - [put](https://docs.perselio.com/reference/putschema.md): Defines/changes schema for items.
  - [delete](https://docs.perselio.com/reference/deleteschema.md): Deletes schema with all items.
- /item/search
  - [post](https://docs.perselio.com/reference/searchitems.md): Retrieves items based specified criteria

## API Reference: Events API
- historical-events
  - [Lists all existing imports.](https://docs.perselio.com/reference/get_event-import.md): Lists all imports that were performed by the client. The IDs can be further used for retrieving import metadata/details or asserting that the import was successfully deleted.
  - [Returns details and metadata of particular import.](https://docs.perselio.com/reference/get_event-import-importid.md)
  - [Performs batch import of given events in given import. Creates new importId if it does not exist yet.](https://docs.perselio.com/reference/put_event-import-importid.md): Main endpoint for importing batch of events. The import of events is non-transactional and each event individually may be successful or fail, ie. the process may end up only partially successful.…
  - [Deletes the given import by its importId.](https://docs.perselio.com/reference/delete_event-import-importid.md): Performs deletion of all events in the import given by its importId. Please note that this is asynchronous operation that is performed on the background and depending on the number of events imported…

## API Reference: SEARCH API
- search
  - [Scenario Search](https://docs.perselio.com/reference/scenario_search_api_v3_search_scenarios__scenarioid__query_post.md)

## API Reference: AI Pulses API
- ai-pulses
  - [List active AI pulses.](https://docs.perselio.com/reference/listaipulses.md): Lists active AI pulses for the authenticated tenant. Results are ordered deterministically by `lastIngestedAt` descending, `updatedAt` descending, `keyVersion` descending, and `id` ascending.…
  - [Resolve AI pulse content.](https://docs.perselio.com/reference/resolveaipulse.md): Resolves an active AI pulse matching the given pulse type and normalized URL for the authenticated tenant. If no active pulse matches, the response is HTTP 204 with an empty body.

## API Reference: Recommendation API
- Recommendation
  - [Get recommended products](https://docs.perselio.com/reference/getrecommendation.md): Allows to generate recommendations for particular user. Provides means to choose particular recommendation model and optionally filter out items based on given filtering parameters.