This guide helps you determine the correct base URL for every type of API request in Experro. Whether you’re managing content or implementing personalized search, selecting the right base URL is crucial for successful integration.

​
Content APIs

Content APIs power everything from content modeling to asset uploads and form submissions.

​
Base URL Format

https://api.experro.app/{service}/{version}/...

​
Examples

https://api.experro.app/content/v2/content-models
https://api.experro.app/content/v2/records

​
Required Headers

HeaderDescription
x-tenant-idYour tenant UUID
x-workspace-idYour workspace UUID
x-environment-idID of the environment
AuthorizationBearer {your_api_token}

​
Discovery APIs

Discovery APIs handle search, autosuggest, and personalized recommendations. These APIs are channel-specific and have a unique base URL for each workspace.

​
Where to Find the Base URL

To locate your API base address:
  1. Log in to the Experro Admin Panel
  2. Go to Workspace Settings → Channels
  3. Click Channel Settings for the relevant channel
  4. Open the Languages tab
  5. Copy the Base URL shown there 6 This is now the base-address in the following example.

​
Example

https://{base-address}/apis/ecommerce-service/public/discovery/v2/search/facet

​
Required Headers

Depending on configuration:
HeaderDescription
x-ecomm-providereCommerce platform (shopify, bigcommerce, etc.)
x-customer-group-idCustomer Group ID from BigCommerce
For more on API token creation and how to fetch header values, see Authentication.