Fetch results from an AI Finder preview

curl --request GET \
  --url https://openapi.enginy.ai/v1/ai-finder/previews/{previewId}/results \
  --header 'x-api-key: <api-key>'

{
  "message": "<string>",
  "data": {
    "previewId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "page": 123,
    "pageSize": 123,
    "hasNextPage": true,
    "records": [
      {
        "id": "<string>",
        "name": "<string>",
        "domain": "<string>",
        "linkedinUrl": "<string>",
        "title": "<string>",
        "location": "<string>",
        "imageUrl": "<string>",
        "extra": {}
      }
    ],
    "totalCount": 123,
    "resolvedProvider": "<string>",
    "result": "<unknown>",
    "userInput": "<string>"
  }
}

AI Finder

Fetch results from an AI Finder preview

What it does. Returns a page of the actual matching records the provider search produced for a cached previewId — i.e. the contacts or companies the filters matched. This is what the web UI displays under the preview. No data is persisted; every call is a live provider API request.

When to use. Call this after a preview has been created (or iterated) when you want to inspect the concrete records before committing to an import, or when you just need a quick lookup of a few results without the full import pipeline.

Pagination. 1-indexed page (default 1, max 50) plus pageSize (default 10, max 25). Providers generally cap their per-request page size at 25, so pageSize is bounded accordingly. Where a provider only supports cursor-based pagination (Crunchbase), this endpoint walks forward from page 1 behind the scenes, so deep pages make several upstream calls — stay within the first 10 pages for Crunchbase or you will receive a 422.

Provider support.

CRUNCHBASE_COMPANIES, CRUNCHBASE_CONTACTS, CRUNCHBASE_INVESTORS — paginated via Crunchbase after_id cursor walks. Capped at 10 pages.
STORELEADS — paginated via StoreLeads native page/page_size params.
LINKEDIN, CRM_CONTACTS, CRM_COMPANIES, GOOGLE_MAPS, THEIRSTACK_TECHNOLOGY, THEIRSTACK_JOBS — supported inline. Provider-specific page ceilings still apply, and some providers may omit totalCount when the upstream API does not expose it.

What you get back. records is a normalized list with optional id, name, domain, linkedinUrl, title, location, and an extra bag of provider-specific fields. Which fields are populated depends on the provider (e.g. title is only set for contact/person providers). totalCount is populated when the provider exposes a total; otherwise rely on hasNextPage to know if another page is available.

Required scope: ACTIONS_WRITE

Rate limit: 100 requests per minute

GET

ai-finder

previews

{previewId}

results

Fetch results from an AI Finder preview

curl --request GET \
  --url https://openapi.enginy.ai/v1/ai-finder/previews/{previewId}/results \
  --header 'x-api-key: <api-key>'

{
  "message": "<string>",
  "data": {
    "previewId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "page": 123,
    "pageSize": 123,
    "hasNextPage": true,
    "records": [
      {
        "id": "<string>",
        "name": "<string>",
        "domain": "<string>",
        "linkedinUrl": "<string>",
        "title": "<string>",
        "location": "<string>",
        "imageUrl": "<string>",
        "extra": {}
      }
    ],
    "totalCount": 123,
    "resolvedProvider": "<string>",
    "result": "<unknown>",
    "userInput": "<string>"
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

previewId

string

required

The previewId returned by a prior preview or iterate call.

Query Parameters

page

integer

default:1

1-indexed page number. Max 50 pages. Defaults to 1.

Required range: 1 <= x <= 50

pageSize

integer

default:10

Records per page. Default 10, max 25 (providers typically cap at 25 per request).

Required range: 1 <= x <= 25

Response

Preview results page

status

enum<string>

required

Available options:

success

message

string

required

data

object

required

Show child attributes

Import an AI Finder preview Get AI playbook

Documentation Index

Authorizations

Path Parameters

Query Parameters

Response