List people similar to one person

GET

https://api.aventure.vc/v1/people/:personId/similar

GET

/v1/people/:personId/similar

curl https://api.aventure.vc/v1/people/04e2bf9c-a100-72ad-83ff-ba69c647b30b/similar \
     -H "Authorization: Bearer <token>"

{
  "content": [
    {
      "person": {
        "id": "string",
        "image": {
          "isMonogram": true,
          "picture": "string"
        },
        "nameAlias": [
          {
            "name": "Bun",
            "displayable": true,
            "type": "nickname"
          }
        ],
        "nameFull": "string",
        "slug": "aventure-vc",
        "text": {
          "expanded": "Canonical expanded summary for grouped text assertions.",
          "generatedDescription": "Acme AI builds AI copilots for growth teams.",
          "short": "Canonical short summary"
        },
        "createdAt": "2024-01-15T09:30:00Z",
        "gender": "string",
        "lastModifiedAt": "2024-01-15T09:30:00Z",
        "nameFirst": "string",
        "nameLast": "string",
        "nameMiddle": "string",
        "nickname": "string",
        "publicId": "pV1StGXR8Z5ab",
        "semanticMatch": {
          "computedAt": "2024-01-15T09:30:00Z",
          "cosineDistance": 1.1,
          "cosineScore": 1.1,
          "modelVersion": "string",
          "rank": 1,
          "sourceHash": "string",
          "sourceId": "string",
          "sourceJson": "string",
          "sourceText": "string",
          "sourceType": "entity"
        },
        "suffix": "string",
        "updatedAt": "2024-01-15T09:30:00Z"
      },
      "similarity": {
        "origin": "precomputed",
        "rank": 1,
        "compositeScore": 1.1,
        "cosineScore": 1.1,
        "matchedSectionWeight": 1.1,
        "sharedSectionCount": 1
      },
      "currentRole": {
        "associationId": 1,
        "entityAddress": [
          {
            "address": 456,
            "addressLine1": "string",
            "addressLine2": "string",
            "association": [
              {
                "id": 123,
                "isCurrent": true,
                "endDate": "2023-01-15",
                "role": "domicile",
                "startDate": "2023-01-15"
              }
            ],
            "city": {
              "name": "Boston",
              "id": 1
            },
            "country": {
              "name": "United States",
              "countryCodeChar2": "US",
              "countryCodeChar3": "USA",
              "id": 1,
              "unRegion": "string",
              "unSubregion": "string"
            },
            "countryAbbrev": "string",
            "createdAt": "2024-01-15T09:30:00Z",
            "fullAddress": "123 Main St, Boston, MA 02110, USA",
            "id": 123,
            "latitude": 1.1,
            "longitude": 1.1,
            "postalCode": "string",
            "state": {
              "name": "Massachusetts",
              "id": 1,
              "stateAbbrev": "MA"
            },
            "stateAbbrev": "string",
            "street": "string",
            "updatedAt": "2024-01-15T09:30:00Z",
            "isCurrent": true,
            "isHq": true,
            "isPrimary": true
          }
        ],
        "entityId": "string",
        "entityLogo": {
          "isMonogram": true,
          "logo": "string",
          "logoSquare": "string"
        },
        "entitySlug": "aventure-vc",
        "entityUrlLink": [
          {
            "url": "https://example.com",
            "urlType": "website",
            "crawlCdnProvider": "cloudflare",
            "crawlRenderMode": "static",
            "createdAt": "2024-01-15T09:30:00Z",
            "id": 1,
            "isCurrent": true,
            "isPrimary": true,
            "owner": {
              "entityId": "string",
              "personId": "string"
            },
            "sourceId": "string",
            "status": "string",
            "statusChecked": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        ],
        "personAddress": [
          {
            "address": 456,
            "addressLine1": "string",
            "addressLine2": "string",
            "association": [
              {
                "id": 123,
                "isCurrent": true,
                "endDate": "2023-01-15",
                "role": "domicile",
                "startDate": "2023-01-15"
              }
            ],
            "city": {
              "name": "Boston",
              "id": 1
            },
            "country": {
              "name": "United States",
              "countryCodeChar2": "US",
              "countryCodeChar3": "USA",
              "id": 1,
              "unRegion": "string",
              "unSubregion": "string"
            },
            "countryAbbrev": "string",
            "createdAt": "2024-01-15T09:30:00Z",
            "fullAddress": "123 Main St, Boston, MA 02110, USA",
            "id": 123,
            "latitude": 1.1,
            "longitude": 1.1,
            "postalCode": "string",
            "state": {
              "name": "Massachusetts",
              "id": 1,
              "stateAbbrev": "MA"
            },
            "stateAbbrev": "string",
            "street": "string",
            "updatedAt": "2024-01-15T09:30:00Z",
            "isCurrent": true,
            "isHq": true,
            "isPrimary": true
          }
        ],
        "personId": "string",
        "personImage": {
          "isMonogram": true,
          "picture": "string"
        },
        "personName": "string",
        "personSlug": "aventure-vc",
        "personUrlLink": [
          {
            "url": "https://example.com",
            "urlType": "website",
            "crawlCdnProvider": "cloudflare",
            "crawlRenderMode": "static",
            "createdAt": "2024-01-15T09:30:00Z",
            "id": 1,
            "isCurrent": true,
            "isPrimary": true,
            "owner": {
              "entityId": "string",
              "personId": "string"
            },
            "sourceId": "string",
            "status": "string",
            "statusChecked": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        ],
        "endDate": "2024-01-15T09:30:00Z",
        "entityName": "string",
        "entityOperatingStatus": "string",
        "entityType": "Company",
        "isCurrent": true,
        "score": 1,
        "startDate": "2024-01-15T09:30:00Z",
        "titleFunction": "string",
        "titleId": 1,
        "titleLevel": "string",
        "titleName": "string"
      }
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Returns people similar to the person at this address. Rows carry the person shape and per-row similarity provenance; load full detail through the person read endpoint. Results are ordered by similarity score (highest first). This endpoint does not support custom sorting. Any signed-in user may call this on every plan. The list is free: it never counts against the monthly record-view allowance, which charges only a separate full-detail view of one record.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Path parameters

personIdstringRequiredformat: "uuid"

Person unique identifier (UUID)

Query parameters

permitMonogrambooleanOptional

Permit monogram fallback

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 10

The size of the page to be returned

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error