Version 0.1.1

TL;DR: Search Insights tools now cover more of the Performance dashboard. You can measure the impact of ranking rule, synonym, and redirect changes, drill into a single query, category, product, or brand, and analyze the paths shoppers take before and after a search or category visit. Nine metric card and table tools are merged into two, so update any workflows that call the old names. Results now respect the site group you pass, and the consent screen opens with a Governing Agreement clause.

Measure the impact of merchandising changes

  • list_discovery_rule_impact returns the Impact measurement tab of the Performance dashboard: every ranking rule, synonym, and redirect changed in the last 45 days, with its performance before and after its own change date.
  • Each rule is measured over a window on either side of its change date. Set the window length with days, from 1 to 90. The default is 45, as in the dashboard.
  • Filter by rule type, scope, or any metric, for example rules where conversion rate fell after the change. Sort by the most recent change or by any metric.
  • get_discovery_rule_impact returns one rule's target queries or categories. Set include_breakdown to true to see which target drove the change.

Drill into a single query, category, product, or brand

  • Three new entity detail tools return the same numbers the dashboard shows when you click a row in a performance table:
    • get_discovery_entity_performance returns the metric cards for one item, with previous-period values and percent change.
    • get_discovery_entity_products lists the products behind one query, category, or brand, with product metrics.
    • get_discovery_entity_sources returns the sources of sale for one product, brand, or category.
  • get_discovery_trend now accepts entity and value to plot the daily series for one item instead of a whole dashboard tab.
  • When an exact-match lookup finds nothing, for example because of letter case, the response includes a hint that explains how to find the stored value.

Analyze shopper paths

  • get_discovery_path_analysis returns the previous and next paths for one search query or category: what shoppers did immediately before or after it, ranked by occurrences.
  • Look at the adjacent page view or the adjacent search or category session. Narrow results by path type, value, URL, or minimum occurrences.

Simpler performance tools, presets, and saved filters

  • Breaking change: Nine metric card and table tools are merged into get_discovery_performance and get_discovery_performance_table. The new tools take the same parameters as the tools they replace. Calls to the old names fail, so update your prompts and workflows:

    Previous toolReplacement
    get_discovery_brand_performanceget_discovery_performance_table(entity="brand")
    get_discovery_category_performanceget_discovery_performance(tab="category")
    get_discovery_category_performance_tableget_discovery_performance_table(entity="category")
    get_discovery_overall_performanceget_discovery_performance(tab="overall")
    get_discovery_page_performanceget_discovery_performance_table(entity="page")
    get_discovery_product_performance_tableget_discovery_performance_table(entity="product")
    get_discovery_products_overviewget_discovery_performance(tab="products")
    get_discovery_query_performanceget_discovery_performance_table(entity="query")
    get_discovery_search_performanceget_discovery_performance(tab="search")
  • Preset filters now use the dashboard's own definitions, so results and default order match what you see in the dashboard. Five presets are new: new_queries, no_product_clicks, top_opportunities, and trending for queries, top_brands for brands, and top_opportunities for categories.

  • list_discovery_saved_filters lists the custom scopes and table filters saved in the dashboard, so you can reuse one by ID instead of rebuilding its conditions.

  • Apply a custom scope on the search, category, and products tabs with scope_conditions or saved_scope_id. Apply a saved filter to a table with saved_filter_id.

  • get_discovery_performance with tab set to overall and breakdown set to true returns each channel's share of overall revenue, visits, add-to-cart, and conversions.

  • get_discovery_trend with compare set to metrics plots up to two metrics side by side over the current period, like the dashboard's Compare metrics chart.

  • device_type now works on get_discovery_trend and the products tab, and every device filter accepts other.

Accurate results for each storefront

  • Search Insights tools now filter results to the sites in the site_group_id you pass. Previously, two storefronts of the same account, such as two country sites, could show identical account-level numbers.
  • Every successful response includes site_scope, which lists the sites applied, so you can confirm whether a result covers one storefront or the whole account.
  • site_group_id is the recommended way to scope results. Pass domain_key alone for sites without a view ID, and pass view_id only when list_discovery_sites shows one.
  • The pixel health tools always return account-wide results. site_group_id doesn't narrow them.

Clearer limits and error messages

  • Performance table, path analysis, and entity tools accept a page_size from 1 to 100. The default is 20. Use page to fetch more rows.
  • days, and any explicit date range, can be up to 730 days. A request with an end date before its start date is rejected with a clear error.
  • Insights tool errors now include the reason a request was rejected, so you know what to change.
  • Metric card tools and get_discovery_trend now return window with the exact date ranges used. Every Insights tool returns environment_used.

Updated consent screen terms

  • The consent screen you see when you sign in now opens with a Governing Agreement clause. Your use of Loomi Connect is governed by your existing agreement with Bloomreach, and data accessed through Loomi Connect is Customer Data under it.
  • Loomi Connect has no additional charge until the Credit Start Date in the first half of 2027.

Bug fixes

  • get_customer_attribute_values returns aggregate and expression values again, instead of an empty list. If none of the requested attributes return a value, the tool now returns success: false with an error. Each value carries the ID you requested, so you can match results to your input.
  • The lowest_converting preset returns the right categories again.
  • get_discovery_entity_sources for a category no longer returns product rows. Each row's type is query, category, homepage, or others.
  • get_discovery_path_analysis no longer returns a "no paths matched" hint when you page past the end of the results.

© Bloomreach, Inc. All rights reserved.