---
title: "Features"
method: GET
path: "/segment-features/{segment}"
tags: ["Audience Segments"]
---

# Features

`GET /segment-features/{segment}`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/segment-features/{segment}`
- Auth: none declared

Features or feature IDs are a way to codify a set of properties. For example, the property "currently a software engineer" could be codified by the feature ID `123` or the property "worked at Microsoft" by the feature ID `456`, and both can be used to search for people that are currently software engineers or that worked at Microsoft.

Features are categorized by segments and by types within each segment. Currently, the supported segments are `persons` and `companies`. Each segment contains features for searching (people or companies) by different criteria.

Up to 530 feature IDs can be returned.

total counts returned feature rows. Feature-name search syntax is distinct from the numeric ID-expression syntax used by segment preview/query. For companies employee\_size, code is required (A through I); search alone is insufficient. expand\_search applies to type=job\_title. For concat\_features=t, a returned row may have null id/mod/name/explanation and feature\_concat="123|456" (illustrative IDs), usable as an OR query.

## Path parameters

- `segment` 'persons' | 'companies', required

## Query parameters

- `type` 'company' | 'job_title' | 'industry' | 'country' | 'company_type' | 'language_prof' | 'job_title_tag' | 'linkedin_school' | 'employee_size', required
- `limit` integer
- `search` string
- `code` string
- `company_id` integer
- `url` string
- `org_id` integer
- `linkedin_url` string
- `expand_search` 't' | 'f'
- `concat_features` 't' | 'f'
- `tag_type` string
- `modifiers` string

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` unknown
    - `page_size` unknown
    - `results` object[]
      - `id` integer, nullable: Feature ID.
      - `mod` string, nullable: Search modifier.
      - `name` string, nullable: Feature name.
      - `description` string, nullable: Feature description.
      - `explanation` string, nullable: Feature explanation.
      - `feature_concat` string, nullable: Null if <code>concat_features</code> is not passed or false.
  - object
    - `errors` object, required

## Other responses

- `400`: Missing or invalid required parameter.
- `403`: Invalid key or insufficient endpoint permissions.
- `404`: No matching feature rows.
- `408`: Feature lookup timed out.
- `429`: Concurrent request limit exceeded.
- `500`: Internal API error.

---

[API](https://skmtc.dev/mixrank/apis/mixrank-api.md) - [All operations](https://skmtc.dev/mixrank/apis/mixrank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixrank/apis/mixrank-api/revisions/786d3fcfe918?raw)