> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Similar People > Find people similar to a reference person. Same request body as `POST /people/search`; requires one of `people_titles`, `people_search_id`, `linkedin_url`, `linkedin_urls`, or `peoples` (the reference). Each result row includes a `similarity_score` (0.0-1.0, higher = closer); rows are ordered by similarity descending. ## OpenAPI ````yaml en-openapi POST /people/search/similar openapi: 3.0.0 info: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/en/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/en/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace profile information and usage statistics - name: Enrichment description: Enrich people and company records with detailed B2B data - name: Lookalike description: Find companies similar to a given company - name: Search description: Search for people, companies, jobs, news, and advertisements with filters - name: Lookup description: >- Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies - name: LinkedIn description: Look up people and company data via LinkedIn profile URLs - name: Redeem description: Redeem credits to unlock people contact details (single and batch) - name: Channels description: Manage outreach channel templates (create, update, delete, list) - name: Monitor description: Create and manage data monitors with webhooks, statistics, and processing - name: Filters description: >- Retrieve available filter values for search parameters (technologies, locations, verticals, etc.) externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /people/search/similar: post: tags: - Lookalike summary: Search for similar people description: >- Find people similar to a reference person. Same request body as `POST /people/search`; requires one of `people_titles`, `people_search_id`, `linkedin_url`, `linkedin_urls`, or `peoples` (the reference). Each result row includes a `similarity_score` (0.0-1.0, higher = closer); rows are ordered by similarity descending. operationId: people_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: Successful response containing people search details. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club location: United States state: Arkansas city: Bentonville contacts: null emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon saved_lists: null company: company_name: Walmart company_url: http://walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 location: United States phones: null company_size_printed: 466,000 company_size: 466000 industry: Retail logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart similarity_score: 0.92 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: A string of words over which we want to filter the results. people_name: type: string example: king description: Filter search results to include a specific people name. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- Job titles associated with the individuals you aim to locate. The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for `software engineer` may yield results for individuals with the title `senior software engineer`. peoples: type: array items: type: string format: uuid description: >- A list of unique identifiers (people_search_id) used for people search operations. management_levels: type: array items: type: string example: - head description: >- The management level that individuals occupy within their current organization. This allows you to locate people who currently hold roles at specific reporting tiers, such as C level or senior level. Check out `management level` endpoints under the Filters tab for more information. departments: type: array items: type: string example: - master_human_resources description: >- The department field can search for people in specific areas of expertise. Check out `department` endpoints under the Filters tab for more information. functions: type: array items: type: string example: - human_resources description: >- The filter field for job functions can specify particular roles or areas of expertise when searching for people. Check out `department functions` endpoints under the Filters tab for more information. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results. Check out `company size` endpoints under the Filters tab for more information. people_locations: type: array items: type: string example: - US - SG - CN description: >- The location where people live. Check out `location` endpoints under the Filters tab for more information. company_locations: type: array items: type: string example: - US - SG - CN description: >- The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- A list of unique identifiers (domain_search_id) used for company and people search operations. domains: type: array items: type: string example: - pubrio.com description: >- List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing. company_filters: type: object description: >- Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*. Accepts the same keys as the top-level company filters (e.g. `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_linkedin_urls`, `is_enable_similarity_search`, `similarity_score`, plus `filter_conditions`). Engine flattens this object to the top level before processing — top-level keys win on conflict. Same shape used by Monitor `company_filters`. See the Filters Overview developer guide for examples. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- The filter key specifying which property to apply the operator to. Keys reference the unified company-filter names (use `places`, not `company_places`). operator: type: string enum: - or - and example: and description: >- The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values. description: >- Per-key AND/OR override for filters in /people/search. Defaults to OR when omitted. See the People + Company Filters developer guide for the full key-remap reference. is_enable_similarity_search: type: boolean description: >- When enabled, the filters listed above that support similarity searches can be filled with free text for specific IDs. similarity_score: type: number format: float example: 0.7 description: >- It is used in conjunction with `is_enable_similarity_search`. This number is used to analyze whether a specific slug (e.g. vertical industry, technology) is similar to the user input, and the higher the number, the more stringent it is. per_page: type: integer example: 25 description: >- The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance. page: type: integer example: 1 description: The page number of the Pubrio data that you want to retrieve. profile_id: type: integer description: >- Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking. Check out `user details` endpoints under the Profile tab for more information. data: type: object nullable: true description: Response info depends on specific endpoint. responses: general_error: description: >- Bad request. The request was malformed or contained invalid parameters. Check the error code and message for details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate limit exceeded. Too many requests were made in a given time period. Retry after the rate limit window resets. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Internal server error. An unexpected error occurred on the server. Contact support if the error persists. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section. in: header ````