API V1
Vertical operations
Vertical operations allow you to grow your dataset by discovering new items (rows) based on a specific criteria or "context" (e.g., "Find SaaS companies in London").
Overview
Vertical operations are primarily focused on Creation (Growth).
- Context: "Growth" is always based on a Field Context (which contains your search prompt/criteria).
- Workflow: Typically, you define your search criteria (Context) in the Cension UI, and then use the API to programmatically trigger the finding of more items.
Create
"Find more rows."
Use this endpoint to trigger a "Growth" operation. This uses an existing Field Context (search criteria) to find and add new rows to your feed.
- Endpoint: POST /api/vertical/create
- Method: POST
- Description: Starts a vertical operation to discover and add new items.
Request body
1{
2 "feedId": 123,
3 "projectId": 456,
4 "fieldContextId": 789,
5 "count": 50
6}Parameters
- feedId (Required): The ID of the feed to add items to.
- projectId (Required): The project ID authorized for this feed.
- fieldContextId (Required): The ID of the Field Context (search criteria) to use. This instructs Cension "what to look for".
- count (Optional): The number of new items to find (default: 10, max: 10,000).