API Documentation

Complete reference for programmatic access to your Cension AI datasets - read processed data, upload new items, and trigger AI enrichment.

Quick Navigation

Base URL: https://api.cension.ai

Authentication

All API requests require an API key sent in the Authorization header. Get your API key from the Exports page in your Cension dashboard under REST API tab.

Header Format:

Authorization: YOUR_API_KEY

Note: Each export has its own unique API key. Generate or regenerate your key from Exports → REST API tab.

GET/api/export/{exportId}

Retrieve your processed dataset in JSON format with all AI-generated content and field values.

Export ID: You can find the Export ID for your dataset by going to your dataset → Exports → REST API tab.

Example Request
curl -X GET "https://api.cension.ai/api/export/3129" \
-H "Authorization: export_1be8065cdea140798135e64d"

Response: Returns a JSON array of products with all their data, field values, and AI-generated content.

POST/api/horizontal/upload

Upload raw data items to your dataset. Use this to add new products before processing them.

Request Body

feedIdintegerRequired

Your feed/dataset ID. You can find this in the address bar when viewing your dataset.

projectIdintegerRequired

Your project ID. You can find this in the address bar when viewing your dataset.

dataItemsarrayRequired

Array of data items to upload. Each item must contain:

  • og_id - A unique identifier for the product/item (string)
  • og_data - The raw product data as a JSON string containing all fields you want to process (e.g., title, brand, description, price, etc.)
Example Request
curl -X POST "https://api.cension.ai/api/horizontal/upload" \
-H "Content-Type: application/json" \
-H "Authorization: export_1be8065cdea140798135e64d" \
-d '{
"feedId": 3129,
"projectId": 2662,
"dataItems": [
{
"og_id": "product-001",
"og_data": "{"title":"Product Name","brand":"Brand"}"
}
]
}'
POST/api/horizontal/create

Process specific items with specific fields (horizontal enrichment). Use this to generate AI content for selected products and fields.

Request Body

ogIdsarrayRequired

Array of product IDs to process

fieldIdsarrayOptional

Array of field IDs to process (auto-fetched from dataset if not provided)

processingModeinteger

0 = FillEmpty, 1 = UpdateExisting, 2 = Both (default)

languagesarray

Languages to process (e.g., ["english", "spanish"])

Example Request
curl -X POST "https://api.cension.ai/api/horizontal/create" \
-H "Content-Type: application/json" \
-H "Authorization: export_1be8065cdea140798135e64d" \
-d '{
"feedId": 3129,
"projectId": 2662,
"ogIds": ["product-001", "product-002"],
"fieldIds": [7902],
"processingMode": 2,
"languages": ["english"]
}'
POST/api/horizontal/upload-and-process

Combined flow: Upload data and immediately start processing. This is the most efficient way to add new products and generate their content in one request.

Example Request
curl -X POST "https://api.cension.ai/api/horizontal/upload-and-process" \
-H "Content-Type: application/json" \
-H "Authorization: export_1be8065cdea140798135e64d" \
-d '{
"feedId": 3129,
"projectId": 2662,
"dataItems": [
{ "og_id": "product-001", "og_data": "{"title":"Product Name"}" }
],
"fieldIds": [7902],
"processingMode": 2
}'
POST/api/vertical/create

Add new rows to Create datasets (vertical processing). Use this to generate entirely new products based on your prompts and field context.

Request Body

countintegerRequired

Number of new rows to create (1-10000)

fieldContextIdintegerRequired

Field context ID from your Create dataset

Example Request
curl -X POST "https://api.cension.ai/api/vertical/create" \
-H "Content-Type: application/json" \
-H "Authorization: export_1be8065cdea140798135e64d" \
-d '{
"feedId": 3129,
"projectId": 2662,
"fieldContextId": 1,
"count": 10
}'

SQL & Saved Queries

Execute custom SQL queries or save them for reuse. Perfect for custom data exports and advanced filtering.

POST/api/sql/execute

Execute a custom SQL query

POST/api/saved-queries

Create a new saved query

GET/api/saved-queries

List all saved queries

POST/api/saved-queries/{id}/execute

Execute a saved query by ID

Cension AI

Real, up‑to‑date, customizable data. Create or enrich any dataset you want with AI.

Copyright © 2025 Cension AB. All rights reserved.