Build targeted audiences by combining demographic, behavioral, and geographic filters.

Step 1: Discover Traits

Use trait_search to find traits by natural language description. See trait_search for full parameter details.

{
  "entity_type": "person",
  "query": "high income professionals interested in golf and fitness",
  "limit": 10
}

Results include trait_hash (use this in expressions), size (population count), and similarity_score. Use trait_list to browse traits by domain if you prefer structured exploration.

Step 2: Build and Execute Your Audience

Combine trait hashes using boolean expressions and query with entity_find. See entity_find for expression syntax and full parameter details.

{
  "entity_type": "person",
  "expression": "a1b2c3d4e5f67890 AND (b2c3d4e5f6789012 OR c3d4e5f67890a1b2)",
  "identifier_types": ["email"],
  "format": "csv"
}

To filter by location, add a location object with latitude, longitude, radius, and unit. Use geocode_location to convert a city name to coordinates first.

{
  "entity_type": "person",
  "expression": "a1b2c3d4e5f67890 AND b2c3d4e5f6789012",
  "location": { "latitude": 37.7749, "longitude": -122.4194, "radius": 25, "unit": "miles" },
  "identifier_types": ["email"],
  "format": "csv"
}

Choose a targeting strategy based on campaign goals:

Related guides:

• ICP Analysis
• Identity Enrichment