Doofinder logo

Support Documentation

Search icon
  • Help
  • Plugins
  • Bigcommerce
  • Installation Guide
  • Install through API - BigCommerce

Install through API - BigCommerce

Follow this step by step guide to Install the Doofinder Bigcommerce through API.

  • If you are a new user, check this article to create a new Doofinder account.

If you have an account already or just created one, follow these guidelines:

1. Log In and Create Store

  1. Log in to your Doofinder Admin Panel.
  2. Click on "Create Store".
  3. If you are new, a "Create store" button will appear on the front page.

    Create Store from the main panel

    If you don't see it or prefer a different method, go to the top bar, click the "Store" dropdown menu, and select "Create Store".

    Create Store from the Store dropdown menu
  4. Once clicked, a pop-up window will appear where you need to:
    • Enter the URL of your website. Doofinder will detect your platform automatically. If not, select your platform in the following block.
    • Select your store's industry.

    Click "Continue".

    Create Store URL, platform and industry

    2. Platform Connection

  5. On the following panel, you’ll need to complete the API Path and the Access Token fields.
  6. Connect your Bigcommerce store, write your API Path and Access Token

    This information can be found in your Bigcommerce backend > Settings > scroll down to the API panel > click on Store-level API Accounts.

    API Path and Access Token Fields on Bigcommerce API
  7. Click on “Create API Account”.
  8. To create an API account on BigCommerce, you must have the appropriate role and permissions. The "Owner" role is required for the installation process. Learn more on BigCommerce User Roles and Permissions.

    Create an API account through BigCommerce
  9. Once in the Create Account panel, name this account as “Doofinder API Key”.
  10. Make sure this is the unique account created under this name. Otherwise, an error could show when proceeding.

    Create account on BigCommerce
  11. Then, search for the API Path link, and paste it on the API Path field in the Platform Connection section in Doofinder.
  12. Api Path link to paste on Create Account
  13. Now, on the OAuth Scopes Panel, select the following options just as shown on the images:
  14. It is important to select the correct 10 options in the API Panel, as shown in the images. If you don't and something goes wrong after creation, you'll need to create a new API account on BigCommerce.

    Oauth scopes selection
    Oauth scopes selection
  15. Save the changes. Now, you will be able to look for the Access Token on the BigCommerce API credentials panel. Copy and paste it back on your Platform Connection section in Doofinder.
  16. Access Token credentials
  17. Once completed, click "Continue". The indexation process should start. You can now start using Doofinder on your Bigcommerce Store.

Doofinder Script

Once you complete the installation process in Doofinder, the script will be automatically added to your theme; no further action is required on your part.

Platform Configuration

To access your platform configuration navigate to your Doofinder's Admin Panel, go to Configuration > Store Settings > Bigcommerce > Platform Configuration. You will find the following functionalities:

  • Doofinder Script: this option is activated by default. From here you can disable the script by switching it off.

  • Update on save: this functionality allows you to keep your store's product data synchronized in real time. You can enable it or disable it from the Platform Configuration section.

  • Custom fields: this feature improves search relevance and allows more precised search results. Enable it when you have indexed product custom fields.

Platform configuration section

API installation troubleshooting

As mentioned earlier, if the OAuth scopes are not selected correctly, the installation process will not function properly.

Make sure the following scopes are changed from "None" to their corresponding fields:

  • Content: "modify"
  • Checkout content: "modify"
  • Customers: "modify"
  • Customers login: "login"
  • Information & settings: "read-only"
  • Products: "read-only"
  • Sites & routes: "read-only"
  • Channel settings: "read-only"
  • Storefront API tokens: "manage"
  • Storefront API customer impersonation tokens: "manage"

Did you find this page helpful?