entity-lookup

Fetch complete user profiles by identity field via V2 Identity Lookup and Data API endpoints.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/lytics/agent-skills --skill entity-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: entity-lookup
Source: https://github.com/lytics/agent-skills/tree/main/entity-lookup
Command: npx skills add https://github.com/lytics/agent-skills --skill entity-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locate and return a user's complete profile by supplying an identity field (like email, user ID, or other identifiers) and its value, eliminating manual lookups.

Core Features & Use Cases

  • Look up individual user profiles by identity field to retrieve full profile data, segment memberships, and metadata.
  • Support multiple identity field types (email, _uid, user_id) and use the V2 Identity Lookup and Data API endpoints to fetch results.
  • Use cases include verifying a user, tracing a user's history, and validating identity-based access.

Quick Start

Follow a simple command to look up a user profile by providing an identity field and its value.

Frequently Asked Questions about entity-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up a user profile by email or user ID?

To look up a user profile by email or user ID, provide the specific identity field and its corresponding value. The tool queries the V2 Identity Lookup and Data API endpoints to return the complete user profile data.

What happens if a user profile lookup returns multiple matches?

When a user profile lookup returns multiple matches, the process includes specific handling logic to manage the results. It also correctly handles not found results and applies URL encoding for robust behavior.

Can I retrieve user segment memberships using an identity lookup?

Yes, you can retrieve user segment memberships using an identity lookup. Fetching complete user profiles by identity field and value returns full profile data, segment memberships, and metadata.

What identity fields are supported for finding user profiles?

Supported identity fields for finding user profiles include common identifiers such as email, _uid, and user_id. The tool operates across these fields to fetch complete user profile results.

How does URL encoding affect user profile data access?

URL encoding ensures robust and predictable behavior during user profile data access. It is applied when supplying an identity field and value to the V2 Data API endpoints, preventing lookup errors.