BigCommerce Category Page Integration with Similar AI

1. Go to Settings → Store-level API accounts.
2. Click Create API account.
3. For Token type, select V2/V3 API token.
4. Fill in the account name.
5. In the OAuth scopes section, change the Products scope from None to modify. This is required because creating category pages needs modify permissions.
6. Click Save.
7. Share the following three values with Similar AI: API Path, Client ID, and Access Token.

Create an invisible parent category that will hold all Similar AI pages. Send a POST request to the categories endpoint:

POST https://api.bigcommerce.com/stores/{store_id}/v3/catalog/trees/categories

Body:
[
  {
    "name": "SimilarPage",
    "url": {
      "path": "/s-test-page/",
      "is_customized": false
    },
    "parent_id": 0,
    "tree_id": 1,
    "description": "<p>Category description</p>",
    "sort_order": 3,
    "page_title": "Similar Test Page",
    "meta_keywords": ["keyword1", "keyword2"],
    "meta_description": "string",
    "layout_file": "category.html",
    "is_visible": true,
    "default_product_sort": "use_store_settings"
  }
]

• -parent_id: 0 - places this category at the top level of your catalog tree.
• -tree_id: 1 - targets your default catalog tree. Check your store if you use multiple trees.
• -is_visible: true - set to false if you want to hide the parent page from navigation.

Save the category ID from the response. You will need it in the next step.

Once your category pages exist, assign products to them using a PUT request to the category-assignments endpoint:

PUT https://api.bigcommerce.com/stores/{store_id}/v3/catalog/products/category-assignments

Body:
[
  {
    "product_id": 456,
    "category_id": 123
  },
  {
    "product_id": 789,
    "category_id": 123
  }
]

• -product_id - the ID of the product you want to assign. Use the product list from step 2 to find IDs.
• -category_id - the ID of the parent or child category page where the product should appear.

You can assign multiple products in a single request by adding more objects to the array.