Skip to main content
The Public API lets you programmatically push product data to Cernel and receive notifications when content is generated or products are updated. Use it for custom integrations, automated pipelines, or any workflow that needs to interact with Cernel beyond the standard integrations.

​
How it works

After creating an API integration, you receive an API token that authenticates your requests. Push product data to Cernel’s REST endpoints, and your products appear in the Catalog ready for enrichment. Configure webhooks to receive real-time notifications when enrichment completes or products change.

​
Why you would use this

Custom integrations

Connect Cernel to any system that can make HTTP requests - your ERP, PIM, custom tools, or internal workflows.

Real-time notifications

Webhooks notify your systems when AI generates new content or products are updated, enabling automated downstream workflows.

​
Setting up the API integration

1

Create the integration

Go to Settings > Integrations, click Add Integration, and select API Integration.Configure the basics:
  • Integration Name - A descriptive name
  • Integration Language - The default language for imported products
  • Product Identifier Field - The field name used as the unique identifier (e.g., id, sku)
  • Product Title Field - The field name used as the product title (e.g., title, name)
The API Integration configuration showing fields for Integration Name, Language, Product Identifier Field (showing 'id'), and Product Title Field (showing 'title')
2

Get your API token

After creating the integration, go to Settings > API. Your API token is displayed here. Use the copy button to copy it to your clipboard.
The API developer settings page showing API configuration and token management
Keep your API token secure. Anyone with the token can push data to your Cernel organization. If you need to rotate the token, click New key - the old token is immediately invalidated.
3

Access the API documentation

Click Visit Documentation or go directly to the API Reference to open the full API documentation. This covers all available endpoints, request formats, authentication, and response schemas.
Your API integration is ready. Use your token to authenticate requests and start pushing product data to Cernel.

​
Configuring webhooks

Webhooks notify your systems when events occur in Cernel. Configure them in Settings > Webhooks.

​
Available webhook types

WebhookTriggerUse case
Attribute ResultWhen an attribute value is generated for a productSync enriched content to external systems in real-time
Product CreatedWhen a new product is created in CernelTrigger downstream workflows when products arrive
Product UpdatedWhen a product is updatedKeep external systems in sync with product changes
1

Set the webhook URL

For each webhook type, enter the URL where Cernel should send POST requests when the event occurs.
2

Test the webhook

Click the Test button (lightning bolt icon) to send a test POST request to your webhook URL. Cernel reports whether the test was successful or failed.
Your webhook is configured. Cernel sends POST requests to your URL whenever the configured event occurs.

​
Building a custom product pipeline

If your products come from an ERP, PIM, custom database, or supplier feed, you can build a fully automated pipeline: push products in via the API, enrich them with AI using Automations, and get the results back programmatically. 
Your System → API (create products) → Cernel → Automation → AI Enrichment
                                                                    ↓
Your System ← Webhook / Changes API ← Enriched Content ← Review & Approve

​
Pushing products

Use the create products endpoint to push product data from your system: 
POST /api/v1/integrations:api/{integration_id}/products
You can send up to 100 products per request. Products are matched by their identifier field; if a product with the same ID already exists, it’s updated instead of duplicated.

​
Getting enriched data back

Option A: Webhooks (real-time) Set up webhooks in Settings > Webhooks to receive notifications when attribute values are generated, products are updated, or new products are created. Cernel sends a POST request to your webhook URL with the event data. Option B: Changes endpoint (polling) Poll the changes endpoint to get a chronological list of enrichment updates: 
GET /api/v1/integrations:api/{integration_id}/changes
Use the cursor-based pagination to track where you left off. Each response includes an offset you pass to the next request.
Webhooks are better for real-time workflows. The changes endpoint is better for batch processing or when you want to pull data on a schedule (e.g., a nightly sync).

​
Example: ERP to Cernel to e-commerce platform

  1. Nightly export from your ERP pushes new/updated products to Cernel via API
  2. Automation enriches each product with descriptions, meta content, and materials
  3. Morning review: your content team reviews results on the Dashboard and approves
  4. Changes endpoint: your e-commerce platform polls for approved changes and publishes them

​
Managing the product lifecycle

Push updated product data to the same endpoint. The identifier field matches against existing products. Updated product data can re-trigger automations if the product matches automation criteria.
Use the delete endpoint to remove products:
DELETE /api/v1/integrations:api/{integration_id}/products/{product_id}/delete
You can choose to fully delete the product or just unlink it from the integration while keeping it in Cernel.
The changes endpoint returns enrichment updates in chronological order. Use it to build an audit trail or sync enriched content to downstream systems.Pass include_all_properties=true to get the full product snapshot with each change (useful for full syncs, but limited to 10 results per request).

​
Frequently asked questions

The full API reference is available at api.platform.cernel.com/api/v1/docs, also accessible from the API Docs tab at the top of this site or from Settings > Developer > API in the app. It covers all endpoints, authentication, request/response formats, and error codes.
Go to Settings > API and click New key. A new token is generated immediately and the old one stops working. Update any systems using the old token.
Webhooks send JSON payloads via HTTP POST requests. The exact payload structure is documented in the API reference. Each webhook type includes the relevant product data and event details.
Each webhook type supports one URL. If you need to notify multiple systems, use your webhook endpoint as a relay that forwards to multiple destinations.

​
What’s next

API Reference

Browse the full API documentation — endpoints, schemas, authentication, and examples.

Enriching Products

Once products are pushed via API, enrich them with AI-generated content.

Automations

Set up automations to automatically enrich products pushed via API.