Public Beta is here!

User Profiling API

Turn raw data into rich, dynamic user understanding — in real time.

curl --request POST
--url https://api.getprofile-ai.com/v1/profile/{id}
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json'
--data '{
  "data": "<string>",
  "input_type": "<string>"
}'

Instant Behavioral Intelligence

GetProfile’s User Profiling API transforms unstructured input — like text, chat logs, bios, and activity streams — into structured, evolving user profiles. This lets you personalize your app, adapt AI responses, and build smarter user-facing features with a single API call.

Whether you’re building an AI assistant, CRM system, or game character memory engine, our profiling layer adds depth and adaptability to every user interaction.

See documentation

What You Can Do with the API

Extract

rich user insights from natural language or behavioral data

Build

evolving memory across multiple interactions

Segment

users by traits, interests, goals, or mood

Power

personalization in LLMs, apps, games, marketing, and more

Replace

manual tagging with real-time AI-driven understanding

Enhance

user interactions with adaptive, context-aware responses

What the API Understands

{
  "profile_id": "123",
  "core_info": {
    "name": {
      "value": "Tomáš",
      "confidence": 0.9
    },
    "gender": {
      "value": "Male",
      "confidence": 0.8
    },
    "location": {
      "value": "Czech Republic",
      "confidence": 0.75
    },
    "language": {
      "value": "Czech",
      "confidence": 0.8
    },
    "age": {
      "value": 28,
      "confidence": 0.85
    }
  },
  "summary": "Tomáš is a 28-year-old male from the Czech Republic who speaks Czech. He is creative and adventurous, with a passion for writing short sci-fi stories, exploring abandoned buildings, and game design. He enjoys low-poly environments and narrative-driven games. Tomáš has a dog named Luna and has recently bought a dog motion capture suit for her. He has a high level of interest in sci-fi and has written about snack-based pathfinding in NPCs.",
  "interests": {
    "hobbies": [
      {
        "value": "writing short sci-fi stories",
        "confidence": 0.9
      },
      {
        "value": "exploring abandoned buildings",
        "confidence": 0.9
      },
      {
        "value": "Writing short sci-fi stories",
        "confidence": 1
      },
      {
        "value": "Exploring abandoned buildings",
        "confidence": 1
      },
      {
        "value": "game design",
        "confidence": 0.9
      }
    ],
    "music": [],
    "food": []
  },
  "personality": {
    "traits": [
      {
        "value": "Creative",
        "confidence": 0.8
      },
      {
        "value": "Adventurous",
        "confidence": 0.7
      }
    ],
    "mood_trends": {}
  },
  "memories": [
    {
      "event": "Bought a new dog motion capture suit for Luna to use in his upcoming short game",
      "date": "YYYY-MM-DD",
      "importance": "high",
      "confidence": 0.9
    },
    {
      "event": "Wrote: “She’s officially the first NPC with snack-based pathfinding.”",
      "date": "YYYY-MM-DD",
      "importance": "high",
      "confidence": 0.9
    }
  ],
  "last_updated": "2025-06-05T18:56:51.123Z",
  "created_at": "2025-06-05T01:08:57.831Z",
  "status": "ready",
  "field_timestamps": {
    "core_info": "2025-06-05T18:56:34.628Z",
    "interests": "2025-06-05T18:56:34.628Z",
    "personality": "2025-06-05T18:56:34.628Z",
    "memories": "2025-06-05T18:56:34.628Z",
    "preferences": "2025-06-05T18:56:34.628Z"
  },
  "preferences": {
    "topics_to_avoid": [],
    "conversation_style": {
      "value": "",
      "confidence": 0.85
    }
  }
}

Each profile generated by GetProfile includes:

  • Personality traits (e.g., curious, introverted)
  • Interests & hobbies (e.g., hiking, photography)
  • Mood & emotional state (e.g., excited, overwhelmed)
  • Goals and motivations (e.g., wants to build confidence)
  • Memories & context history (e.g., last known topics or behavior)
  • AI-generated summary for instant understanding or LLM memory injection

All of this is generated from raw inputs — no manual structuring or labeling required.

How It Works

Use the POST /v1/profile/{profile_id} endpoint with any structured or unstructured input

curl -X POST "https://api.getprofile-ai.com/v1/profile/user_123"
-H 'Authorization: Bearer <token>'
-H 'Content-Type: application/json'
--data '{
  "data": "<any>",
  "input_type": "<string>"
}'

Privacy & Data Principles

We never store raw user inputs beyond what’s needed for processing.

Ephemeral-first

Raw data is discarded post-processing

GDPR & CCPA-friendly

You control what gets sent and stored

Fully deletable

Remove profiles at any time via API or dashboard

api keys dashboard light

Developer-Friendly by Design

  • RESTful API with predictable endpoints and JSON payloads
  • Asynchronous processing for performance at scale
  • Monitoring and analytics
  • Secure authentication using API keys
  • Flexible data model
  • SDKs & examples for Node.js, Python, and more

Easy integration with your favorite tools

Connect seamlessly with popular platforms and services to enhance your workflow

Start for free. Scale as you grow.

More personal apps — in minutes. Get started for free. No credit card required.