API V1

Exports

Retrieve data from a specific export configuration.

Get export data

"Download your data."

Use this endpoint to retrieve the execution results of an existing Export configuration. This allows you to fetch cleaned, enriched, and standardized data programmatically.

Endpoint: GET /api/export/{exportId}
Method: GET
Description: Retrieves data for a specific export.

Parameters

exportId (Required): The ID of the export to retrieve.
page (Optional): Page number (default: 1).
limit (Optional): Number of items per page (default: 100).
operationId (Optional): Filter the exported data to return only the items processed in a specific operation/run (e.g., ?operationId=4836).

Response

1{
2  "success": true,
3  "data": {
4      "items": [
5        {
6           "company": "Acme Corp",
7           "website": "acme.com",
8           ...
9        }
10      ],
11      "total_count": 145
12  }
13}

Polled export workflow

"Recommended integration pattern for bulk updates."

When constantly adding new rows to a dataset, exporting the entire dataset can become slow and inefficient over time. Cension supports filtering your export by a specific operation ID, allowing you to fetch only the newly processed items from that specific run.

Recommended Integration Flow

Step 1: Start a batch operation via POST /api/horizontal/upload-and-process or POST /api/horizontal/create. Keep the operationId returned in the response.
Step 2: Poll the status of the operation via GET /api/operations/{operationId} until it returns status: "completed".
Step 3: Download the results of that specific run by calling GET /api/export/{exportId}?operationId={operationId}.

Example: Polling Operation Status

Check progress of a running operation by its ID:

1// GET /api/operations/4836
2{
3  "success": true,
4  "operation": {
5    "operationId": 4836,
6    "feedId": 123,
7    "projectId": 456,
8    "operationType": "horizontal",
9    "status": "completed",
10    "processedItems": 50,
11    "totalItems": 50,
12    "startedAt": "2026-06-01T05:23:00.000Z",
13    "completedAt": "2026-06-01T05:24:15.000Z",
14    "errorMessage": null
15  }
16}

Example: Scoped Export Request

Fetch only the items that were processed during that operation:

1// GET /api/export/459?operationId=4836
2{
3  "success": true,
4  "data": {
5    "items": [
6      {
7        "company": "Acme Corp",
8        "website": "acme.com",
9        "ceo_name": "John Doe",
10        "linkedin_url": "https://linkedin.com/in/johndoe"
11      }
12    ],
13    "total_count": 1
14  }
15}