Skip to main content

Search APIs

Configuring and enabling Search APIs for shop users.

Summary

Procurement can configure any available Search APIs and enable them for selected buyers. This will allow those buyers to receive search results that include products obtained from those suppliers' or providers' Search API catalogues.

INFORMATION

Not all of Axiom features can be fully utilised when involving products retrieved from Search APIs, see here for a full list of features.

Viewing Available Search APIs

To view all available Search APIs, navigate to the Search APIs page of the platform within the Settings area, or by searching for Search APIs in the main search bar.

The Search APIs page displays a table of all available Search APIs. These can be filtered by Connected or Not Connected Search APIs. Connected Search APIs have 1 or more configurations. Multiple configurations may be needed for reasons such as to enable multiple regions. Clicking on a Search API with configurations will take you to a page where the configurations can be viewed and managed.

Configuring a New Search API

  1. To add the first configuration to a Search API, click the Configure button for the appropriate row on the Search APIs page in the Settings area of the platform.

  2. Enter a name for the configuration and select which preset/s of users to apply the configuraiton to.

  3. Fill out the required Config Details for this configuration. These fields will vary based on the selected Search API, and be specific to their systems and authentication process.

  1. Optionally click the Enabled toggle to change it to Disabled - this will ensure the configuration isn't immediately live for buyers after saving it.

  2. Review all entries then click Save to create the configuration.

  3. To ensure Search API products for this configuration can be found and purchased by buyers, check that appropriate sharing settings are in place for the relevant supplier - see more information here.

Adding Additional Configurations to a Search API

  1. To add additional configurations to a Search API, click on the appropriate row on the Search APIs page in the Settings area of the platform.

  2. All current configurations can be seen in the table on this detail page for the selected Search API. Click the + New config button to begin creating a new configuration.

  3. Enter a name for the configuration and select which preset/s of users to apply the configuraiton to.

  4. Fill out the required Config Details for this configuration. These fields will vary based on the selected Search API, and be specific to their systems and authentication process.

  1. Optionally click the Enabled toggle to change it to Disabled - this will ensure the configuration isn't immediately live for buyers after saving it.

  2. Review all entries then click Save to create the configuration.

  3. To ensure Search API products for this configuration can be found and purchased by buyers, check that appropriate sharing settings are in place for the relevant supplier - see more information here.

Editing Configurations

To edit a Search API configuration, either click the appropriate row in the configuration table for the selected Search API, or open the menu for the row and select Edit.

Removing Configurations

To remove a Search API configuration, open the menu for the appropriate configuration row of the selected Search API and select Remove.

Enabling and Disabling Search APIs

To enable a disabled Search API configuration, open the menu for the appropriate configuration row and select Enable.

To disable an enabled Search API configuration, open the menu for the appropriate configuration row and select Disable.

Search API Sharing Settings

For appropriate buyers to be able to view and purchase the products of a particular Search API, relevant sharing settings must be configured for the supplier in question, with the sharing settings including supplier punchout identifiers and relevant users (presets or otherwise).

To adjust the sharing settings, head over to the corresponding supplier page for the Search API to view any existing sharing settings (e.g. the Scientist.com supplier for the Scientist.com Search API). Navigate to the Sharing Settings tab to edit or add any additional sharing settings.

Supported Feature List

Not all features can be utilised when the method of data provision is through a Search API integration. The following table compares available features through the 3 different methods of supplier data provision.

FeatureCSV UploadCatalogue APISearch API
Approvals👍👍
Axiom Promotions Engine👍👍
Buyer Permissions👍👍Only purchase permissions
Multi-Lingual product info👍👍Only if supported by supplier
Multi-Lingual Search👍👍Only if supported by supplier
Order Logs👍👍👍
Order Savings Calculations👍👍Some, not all
Price Analytics👍👍
Procurement product view👍👍
Product deduplication👍👍Yes but only in real time (slower)
Product Export👍👍
Real-Time Data👍👍
Search Analytics👍👍
Search RelevancyControllableControllableDependent on the supplier
Search Rules👍👍