Import an AI Finder preview

curl --request POST \
  --url https://openapi.enginy.ai/v1/ai-finder/previews/{previewId}/import \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "listId": 123,
  "maxCount": 500
}
'

{
  "message": "<string>",
  "data": {
    "actionsId": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "listId": 123,
    "workflowId": "<string>",
    "previewId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

AI Finder

Import an AI Finder preview

What it does. Takes a cached previewId and starts the provider-specific import workflow into a destination list. This is the final step for new-list building after you create or identify the destination list. Returns an actionsId you can use to monitor progress.

When to use. Call this as the final step of the preview → iterate → import flow, once you’re happy with the filters. The preview must still be valid (24h TTL).

Preconditions.

listId must be a list owned by this client.
The list type must match the preview’s entity: pass a contact list for CONTACT-typed previews (LINKEDIN contacts, CRM_CONTACTS, CRUNCHBASE_CONTACTS, CRUNCHBASE_INVESTORS), and a company list for COMPANY-typed previews (LINKEDIN companies, CRM_COMPANIES, CRUNCHBASE_COMPANIES, STORELEADS, THEIRSTACK_TECHNOLOGY, THEIRSTACK_JOBS, GOOGLE_MAPS). Mismatch returns 422.
maxCount is an integer between 100 and 2500 in increments of 100.

What you get back. An actionsId — use it with:

GET /v1/actions/{actionsId}/status to poll progress.
The actionsId filter on /v1/contacts and /v1/companies to fetch the imported records once they land.

The preview is NOT evicted after import — you can re-import the same preview into a different list until its 24h TTL expires.

Required scope: ACTIONS_WRITE

Rate limit: 10 requests per minute

POST

ai-finder

previews

{previewId}

import

Import an AI Finder preview

curl --request POST \
  --url https://openapi.enginy.ai/v1/ai-finder/previews/{previewId}/import \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "listId": 123,
  "maxCount": 500
}
'

{
  "message": "<string>",
  "data": {
    "actionsId": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "listId": 123,
    "workflowId": "<string>",
    "previewId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

previewId

string

required

The previewId returned by a prior preview or iterate call.

Body

application/json

listId

integer

required

Destination list ID. Must be owned by this client. The list type must match the preview's entity — pass a contact list when the preview's entity is CONTACT, or a company list when it is COMPANY. Mismatch returns 422. Create a list first via POST /v1/lists if needed.

maxCount

integer

required

Maximum number of results to import into the destination list. Integer between 100 and 2500, in increments of 100 (100, 200, 300, …, 2500). The actual count may be lower if the search yields fewer matches.

Required range: 100 <= x <= 2500

Response

AI Finder import started

status

enum<string>

required

Available options:

success

message

string

required

data

object

required

Show child attributes

Refine an AI Finder preview Fetch results from an AI Finder preview

Documentation Index

Authorizations

Path Parameters

Body

Response