--- title: "Search Person Entities" method: POST path: "/data/searches/people" tags: ["Search"] --- # Search Person Entities `POST /data/searches/people` ## Request - Base URL: `https://api.crunchbase.com/v4` - URL: `https://api.crunchbase.com/v4/data/searches/people` - Auth: API key in header `X-cb-user-key` 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` 'address' | 'category' | 'category_group' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'investment' | 'ipo' | 'job' | 'location' | 'organization' | 'ownership' | 'person', 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_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` 'address' | 'category' | 'category_group' | 'degree' | 'diversity_spotlight' | 'event' | 'event_appearance' | 'investment' | 'ipo' | 'job' | 'location' | 'organization' | 'ownership' | 'person', 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_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.dev/crunchbase/apis/core-financials-package.md) - [All operations](https://skmtc.dev/crunchbase/apis/core-financials-package/llms.txt) - [OpenAPI document](https://skmtc.dev/crunchbase/apis/core-financials-package/revisions/139e6b908e63?raw)