---
title: "Search Person Entities"
method: POST
path: "/data/searches/people"
tags: ["Search"]
---

# Search Person Entities

`POST /data/searches/people`

Can perform more complex filtering based on the query defined in the request body

## Request body

- PersonEntitySearch — EntitySearch for Person search
  - `after_id` string, uuid — Used to paginate search results to the next page. after_id should be the uuid of the last item in the current page. May not be provided simultaneously with before_id.
  - `before_id` string, uuid — Used to paginate search results to the previous page. before_id should be the uuid of the first item in the current page. May not be provided simultaneously with after_id.
  - `field_ids` string[], required — The list of field_ids to include in the result
  - `limit` integer — Number of rows to return. Default is 100, min is 1, max is 1000.
  - `order` Order[] — Order in which the search results should be returned
    - `field_id` string, required — Name of the field to sort on
    - `nulls` 'first' | 'last'
    - `sort` 'asc' | 'desc', required
  - `query` Predicate[], required — Search query to perform on the designated entity
    - `field_id` string, required — The field to operate on
    - `operator_id` 'blank' | 'eq' | 'not_eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'starts' | 'contains' | 'not_contains' | 'between' | 'includes' | 'not_includes' | 'includes_all' | 'not_includes_all' | 'domain_eq' | 'not_domain_eq' | 'domain_blank' | 'domain_includes' | 'not_domain_includes', required — Search operations for use in predicates * between - Between. Provide two values in "values" * blank - Is blank. Possible values in "values" is "true" or "false" * contains - Contains * domain_blank - Domain is blank. Possible values in "values" is "true" or "false" * domain_eq - Domain equals * domain_includes - Domain includes any * eq - Equals * gt - Greater than * gte - Greater than or equal to * includes - Includes any * includes_all - Includes all * lt - Less than * lte - Less than or equal to * not_contains - Does not contain * not_domain_eq - Domain not equal * not_domain_includes - Domain does not include * not_eq - Does not equal * not_includes - Does not include * not_includes_all - Does not include all * starts - Starts with
    - `type` 'predicate', required — The type of the query (Predicate)
    - `values` union[] — Values array with data type matching field_id type
      - union
        - string
        - number
        - boolean

## Response `200`

Results are identifiers matching the search query

- object — Search results include Person entities
  - `count` integer — Total number of Person entities
  - `entities` object[] — List of Person entities
    - `properties` Person
      - `aliases` string[] — Alternate or previous names for the individual
      - `born_on` string, date — The birthdate of the person
      - `created_at` string, date-time
      - `description` string — Text from a Person's biography
      - `died_on` string, date — The date when a person died
      - `entity_def_id` 'person' — * person - Person
      - `facebook` Link — An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `facet_ids` string[]
      - `first_name` string — First name of a Person
      - `gender` 'female' | 'male' | 'agender' | 'androgyne' | 'androgynous' | 'bigender' | 'ftm' | 'mtf' | 'gender_fluid' | 'gender_nonconforming' | 'gender_questioning' | 'gender_variant' | 'genderqueer' | 'non_binary' | 'neutrois' | 'pangender' | 'transgender_person' | 'transgender_female' | 'transgender_woman' | 'transgender_male' | 'transgender_man' | 'transfeminine' | 'transmasculine' | 'transsexual_person' | 'transsexual_female' | 'transsexual_woman' | 'transsexual_male' | 'transsexual_man' | 'two_spirit' | 'other' | 'not_provided' — A Person's gender * agender - Agender * androgyne - Androgyne * androgynous - Androgynous * bigender - Bigender * female - Female * ftm - Female to Male (FTM) * gender_fluid - Gender Fluid * gender_nonconforming - Gender Nonconforming * gender_questioning - Gender Questioning * gender_variant - Gender Variant * genderqueer - Genderqueer * male - Male * mtf - Male to Female (MTF) * neutrois - Neutrois * non_binary - Non-Binary * not_provided - Prefer not to identify * other - Other * pangender - Pangender * transfeminine - Transfeminine * transgender_female - Transgender Female * transgender_male - Transgender Male * transgender_man - Transgender Man * transgender_person - Transgender Person * transgender_woman - Transgender Woman * transmasculine - Transmasculine * transsexual_female - Transsexual Female * transsexual_male - Transsexual Male * transsexual_man - Transsexual Man * transsexual_person - Transsexual Person * transsexual_woman - Transsexual Woman * two_spirit - Two-Spirit
      - `identifier` EntityIdentifier, required — Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required — Universally Unique Identifier
        - `value` string
      - `image_id` string — The profile image of the person on Crunchbase
      - `image_url` string — The url of the profile image
      - `investor_stage` string[] — This describes the stage of investor this person is (e.g. Angel, Fund of Funds, Venture Capital)
      - `investor_type` string[] — This describes the type of investor the person is (e.g. Angel, Fund of Funds, Venture Capital)
      - `last_name` string — Last name of a Person
      - `layout_id` 'investor' — This is the auto-generated layout for the profile * investor - Investor Layout
      - `linkedin` Link — An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `location_group_identifiers` LocationIdentifier[] — Where the person is located (e.g. San Francisco Bay Area, Silicon Valley)
        - `entity_def_id` string, required — What type of entity this be
        - `image_id` string — Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required — Globally unique id of this entity
        - `value` string — Textual representation of this entity (i.e. its "name")
      - `location_identifiers` LocationIdentifier[] — Where the person is located (e.g. Europe, Menlo Park, China)
        - `entity_def_id` string, required — What type of entity this be
        - `image_id` string — Optionally provided location to obtain an image representing this entity
        - `location_type` 'city' | 'region' | 'country' | 'continent' | 'group'
        - `permalink` string — Optionally provided within Entity Def unique nice id of this entity
        - `uuid` string, uuid, required — Globally unique id of this entity
        - `value` string — Textual representation of this entity (i.e. its "name")
      - `middle_name` string — Middle name of a Person
      - `name` string — Full name of a Person
      - `num_articles` number — Number of news articles that reference the Person
      - `num_current_advisor_jobs` number — Total number of current Advisors and Board roles the person has
      - `num_current_jobs` number — Total number of current Jobs the person has
      - `num_diversity_spotlight_investments` number — Total number of diversity investments made by an investor
      - `num_event_appearances` number — Total number of events the individual appeared in
      - `num_exits` number — Total number of Exits
      - `num_exits_ipo` number — Total number of Exits (IPO)
      - `num_founded_organizations` number — Number of Organizations that the person founded
      - `num_investments` number — Number of Investments the Individual has participated in
      - `num_jobs` number — Total number of Jobs the person has
      - `num_lead_investments` number — Number of Investments led by the Individual
      - `num_partner_investments` number — Number of Investments the Individual has partnered in
      - `num_past_advisor_jobs` number — Total number of past Board and Advisor roles the person has
      - `num_past_jobs` number — Total number of past Jobs the person has
      - `num_portfolio_organizations` number — Number of portfolio companies associated to the Person
      - `permalink` string
      - `permalink_aliases` string[] — These are the alternative aliases to the primary permalink of the Organization
      - `primary_job_title` string — The person's primary job title
      - `primary_organization` EntityIdentifier — Every entity in the system has a unique identifier that contains all necessary properties to represent it.
        - `entity_def_id` 'acquisition' | 'address' | 'award' | 'category' | 'category_group' | 'market_insight' | 'market_insight_reason' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'fund' | 'funding_round' | 'growth_insight' | 'investment' | 'investor_insight' | 'investor_match' | 'ipo' | 'job' | 'key_employee_change' | 'layoff' | 'legal_proceeding' | 'location' | 'micro_category' | 'organization' | 'org_similarity' | 'product_similarity' | 'ownership' | 'partnership_announcement' | 'person' | 'press_reference' | 'product' | 'product_launch' | 'research_insight', required
        - `image_id` string
        - `permalink` string
        - `uuid` string, uuid, required — Universally Unique Identifier
        - `value` string
      - `rank` number — Algorithmic rank assigned to the top profiles on Crunchbase
      - `rank_delta_d30` number, double — Movement in Rank over the last 30 days using a score from -10 to 10
      - `rank_delta_d7` number, double — Movement in Rank over the last 7 days using a score from -10 to 10
      - `rank_delta_d90` number, double — Movement in Rank over the last 90 days using a score from -10 to 10
      - `rank_person` number — Algorithmic rank assigned to the top 100,000 most active People
      - `short_description` string — Text of Person Description, Industries, and Industry Groups
      - `twitter` Link — An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `updated_at` string, date-time
      - `uuid` string, uuid
      - `website` Link — An object representing both the url and some labeling text for that url
        - `label` string
        - `value` string
      - `website_url` string — Link to a Person's website
    - `uuid` string, uuid — UUID of the entity

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Request Failed

---

[API](https://skmtc.net/crunchbase/apis/firmographic-package.md) · [All operations](https://skmtc.net/crunchbase/apis/firmographic-package/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchbase/firmographic-package/revisions/3277c0d3e46a/schema)