{"uid":"cap_kNIU80padCb5Lf5ep9ik7","slug":"agents-pubrio-com-search-for-similar-people-07f8283d","name":"Search for Similar People","description":"Pubrio detects when companies enter new markets and returns the company and people data behind each move. Expansion signals (local hiring, new offices and entities, localized ads, news, cloud hosting) are typed, dated and tied to evidence across 200+ markets, with strong coverage of Asia-Pacific and other markets that Western-built datasets miss. The graph covers 800M+ companies and 560M+ contacts from 50+ local data sources, refreshed daily. Search companies, people, job postings, news, ads and cloud footprints with filters or a plain-language query; look up records by domain, LinkedIn URL or Pubrio id; find lookalike companies and people; read hiring, news, advertising and cloud insights for one company; and reveal verified work emails, personal emails and phone numbers. Each call costs the number of credits listed on its endpoint. This server is a pay-per-use, transparent proxy in front of Pubrio's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.pubrio.com/people/search/similar?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","default":1,"example":1,"description":"Page number, starting at 1."},"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."},"peoples":{"type":"array","items":{"type":"string","format":"uuid"},"description":"A list of unique identifiers (people_search_id) used for people search operations."},"per_page":{"type":"integer","default":25,"example":25,"maximum":25,"description":"Records per page, 1 to 25. Defaults to 25."},"companies":{"type":"array","items":{"type":"string","format":"uuid"},"description":"A list of unique identifiers (domain_search_id) used for company and people search operations."},"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."},"departments":{"type":"array","items":{"type":"string"},"example":["master_human_resources"],"description":"The department field can search for people in specific areas of expertise."},"people_name":{"type":"string","example":"king","description":"Filter search results to include a specific people name."},"search_term":{"type":"string","example":"pubrio","description":"A string of words over which we want to filter the results."},"linkedin_url":{"type":"string","description":"A single LinkedIn profile URL to use as the reference."},"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/"},"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."},"company_filters":{"type":"object","example":{"technologies":[37,152],"founded_dates":[2015,2023],"company_locations":["US"],"filter_conditions":[{"key":"technologies","operator":"and"}]},"description":"Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*."},"people_locations":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"The location where people live."},"people_search_id":{"type":"string","description":"Pubrio person id to use as the reference."},"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."},"company_locations":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"The location of the company headquarters."},"filter_conditions":{"type":"array","items":{"type":"object","properties":{"key":{"enum":["keywords","verticals","vertical_categories","vertical_sub_categories","technologies","categories","social_media"],"type":"string","example":"technologies","description":"The filter key specifying which property to apply the operator to."},"operator":{"enum":["or","and"],"type":"string","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."},"management_levels":{"type":"array","items":{"enum":["c_suite","director","entry","founder","head","intern","manager","owner","partner","senior","vp"],"type":"string"},"example":["c_suite","vp"],"description":"Reporting tier of the person. The C-suite slug is c_suite, not c_level. An unknown slug matches nobody."},"department_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."},"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/"},"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."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","nullable":true,"description":"Response info depends on specific endpoint."},"metadata":{"type":"object","description":"Request context — echoed `filters` and `parameters`, plus a `profile` block with `credit`, `topup_credit` and `total_credit_cost` when credit accounting is requested."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P-NN1jaZz_svHHmkRGZ8d","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_WY3rz-x988AszOPPILpnW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"Find people similar to a reference person, LinkedIn URL, or job title using Pubrio's 800M+ contact graph, with each result scored by similarity.","exampleAgentPrompt":"Find me people on Pubrio similar to this LinkedIn profile — https://www.linkedin.com/in/jane-doe-cto — filtered to companies in the fintech space with 50–200 employees, and show me the top 25 results with their similarity scores.","exampleUseCases":[{"title":"Lookalike prospecting from best customer","prompt":"I have a great customer — their LinkedIn is https://www.linkedin.com/in/john-smith-vp-sales. Can you find me 25 people similar to him on Pubrio, ideally at SaaS companies with 11 to 200 employees?"},{"title":"Talent sourcing from reference candidate","prompt":"We love this candidate's profile — https://www.linkedin.com/in/alice-zhang-data-engineer. Use Pubrio to find me similar people, limited to companies in the cloud infrastructure space."},{"title":"Building lookalike list from job title","prompt":"I want to find people similar to a 'Head of Growth at a Series B startup' — can you pull a list of lookalike contacts from Pubrio filtered to companies in the US with 50 to 500 employees?"}],"resultDescription":"Returns a paginated list of person records each containing profile details (name, title, company, LinkedIn URL, contact info) and a similarity_score between 0 and 1 indicating closeness to the reference. Also includes metadata with echoed filters, pagination parameters, and credit usage (credit, topup_credit, total_credit_cost).","failureModes":["HTTP 416 if page exceeds subscription max_search_page or per_page exceeds max_search_per_page (code 41613)","No reference supplied — request rejected if none of people_search_id, linkedin_url, linkedin_urls, peoples, or people_titles is provided","Invalid UUID format in peoples array returns validation error","No results returned if filters are too restrictive in combination with the reference","Credit exhaustion results in a credit-related error response"],"whenToPreferThis":"Use this endpoint when you need to discover new contacts who resemble a known reference person — ideal for lookalike prospecting, talent sourcing, or expanding a persona-based list. Prefer this over general people search when you have a seed identity (LinkedIn URL, Pubrio ID, or job title) and want similarity-ranked results rather than filter-only results. Choose this over company-level endpoints when the unit of interest is an individual professional rather than an organization.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T21:42:15.683Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-search-for-similar-people-07f8283d"}