GET
/
v1
/
search
curl --request GET \
  --url https://api.getprofile-ai.com/v1/search \
  --header 'Authorization: Bearer <token>'
{
  "profiles": [
    {
      "profile_id": "<string>",
      "tenant_id": "<string>",
      "status": "processing",
      "core_info": {
        "name": {
          "value": "<string>",
          "confidence": 123
        },
        "age": {
          "value": 123,
          "confidence": 123
        },
        "gender": {
          "value": "<string>",
          "confidence": 123
        },
        "location": {
          "value": "<string>",
          "confidence": 123
        }
      },
      "interests": {},
      "personality": {
        "traits": [
          {
            "value": "<string>",
            "confidence": 123
          }
        ],
        "mood_trends": {
          "default": {
            "value": "<string>",
            "confidence": 123
          },
          "recent": {
            "value": "<string>",
            "confidence": 123
          }
        }
      },
      "memories": [
        {
          "event": "<string>",
          "date": "2023-12-25",
          "importance": "low",
          "confidence": 123
        }
      ],
      "preferences": {
        "conversation_style": {
          "value": "<string>",
          "confidence": 123
        },
        "topics_to_avoid": [
          {
            "value": "<string>",
            "confidence": 123
          }
        ]
      },
      "field_timestamps": {},
      "update_log": [
        {
          "extracted_on": "2023-11-07T05:31:56Z",
          "changes": {}
        }
      ],
      "last_updated": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "summary": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "pageSize": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
query
string

Natural language search query. If provided, enables vector-based semantic search.

​
sensitivity
integer
default:63

Vector search similarity threshold (0-100). Higher = stricter match.

​
filterBy
string

Field to filter by (e.g. name, location, language, id).

​
filterValue
string

Value to filter for (case-insensitive partial match).

​
sortBy
string
default:last_updated

Field to sort by (e.g. last_updated, created_at, name). Ignored when using vector search.

​
sortOrder
enum<string>
default:desc

Sorting order: asc or desc.

Available options:
asc,
desc
​
page
integer
default:1

Page number for pagination.

​
pageSize
integer
default:10

Number of profiles per page.

Response

200
application/json

A list of matching profiles and pagination metadata

The response is of type object.