Core Tools

Core tools are the fundamental building blocks for data enrichment and audience discovery. Use these tools directly to query clusters, resolve identities, retrieve profiles, and build audiences from criteria.

Cluster Discovery

list_clusters

Discover available clusters by browsing domains. Use this tool to identify cluster IDs before calling find_persons.

search_clusters

Semantic search for clusters using natural language descriptions. Use this when you know what you're looking for conceptually but don't know the exact cluster names.

get_cluster

Retrieve analytics for a semantic cluster including top predictors, discriminators, and exemplars.

Identity Resolution

resolve_identities

Resolve person identities by matching emails, phones, addresses, or mobile advertising IDs (MAIDs). Returns person IDs with quality scores.

get_person

Retrieve detailed person profiles by person IDs with optional export to CSV, JSON, or JSONL formats.

find_persons

Find persons using cluster criteria and/or location filters. Supports boolean expressions (AND/OR/NOT) and geospatial radius search.

Utilities

submit_feedback

Submit structured feedback on data quality, tool behavior, or results associated with a workflow session.

generate_url_for_upload

Generate a presigned URL for uploading customer CSV data. Returns a csv_key for use with workflow tools.

generate_download_url

Generate a presigned download URL for full file access. Use when you need the complete file rather than a paginated sample.