{"uid":"cap_rWSl5QWJevXieEud2WRGi","slug":"agents-pubrio-com-pubrio-similar-company-search-4ce14585","name":"Pubrio Similar Company Search","description":"Find companies similar to a reference company. Supply exactly one singular identifier (`domain_search_id`, `domain`, `linkedin_url` or another `*_url`). Each row carries a `similarity_score` between 0 and 1.","url":"https://agents.pubrio.com/companies/search/similar?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","anyOf":[{"title":"domain_search_id","required":["domain_search_id"]},{"title":"domain","required":["domain"]},{"title":"linkedin_url","required":["linkedin_url"]},{"title":"tiktok_url","required":["tiktok_url"]},{"title":"wantedly_url","required":["wantedly_url"]},{"title":"tw104_url","required":["tw104_url"]},{"title":"rocketpunch_url","required":["rocketpunch_url"]},{"title":"remember_url","required":["remember_url"]},{"title":"youtrust_url","required":["youtrust_url"]}],"properties":{"page":{"type":"integer","default":1,"example":1,"description":"Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**."},"domain":{"type":"string","example":"stripe.com","description":"The company's primary domain, for example `stripe.com`."},"places":{"type":"array","items":{"type":"string"},"example":["Tokyo"],"description":"Place names (city, region) used to filter results. Accepts localized or English place names."},"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."},"keywords":{"type":"array","items":{"type":"string"},"example":["ecommerce","ai","fintech"],"description":"A list of keywords to filter companies by relevance, specialties, or descriptions."},"per_page":{"type":"integer","default":25,"example":25,"maximum":25,"description":"Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set."},"revenues":{"type":"array","items":{"type":"integer"},"example":[0,100000],"description":"Minimum and maximum range of company revenue."},"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. \n\n Check out `company size` endpoints under the Filters tab for more information."},"locations":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out `location` endpoints under the Filters tab for more information."},"tw104_url":{"type":"string","description":"104 (Taiwan) profile URL for the company."},"verticals":{"type":"array","items":{"type":"integer"},"description":"A list of `vertical_id` used to search for companies in a specific vertical or industry. To find the ID, call the `vertical` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"AI\"]`."},"categories":{"type":"array","items":{"type":"integer"},"description":"A list of `category_id` used to search for specific categories of technology used by companies. To find the ID, call the `category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"CDN\"]`."},"company_id":{"type":"string"},"job_titles":{"type":"array","items":{"type":"string"},"example":["sales manager","marketing manager"],"description":"Job titles associated with the individuals you aim to locate. \n\n 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`."},"tiktok_url":{"type":"string","description":"TikTok profile URL for the company."},"company_name":{"type":"string","example":"pubrio","description":"Filter search results to include a specific company name. \n \n If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted."},"linkedin_url":{"type":"string","description":"LinkedIn company URL."},"remember_url":{"type":"string","description":"Remember profile URL for the company."},"technologies":{"type":"array","items":{"type":"integer"},"description":"A list of `tag_id` used to search for specific technologies used by companies. To find the ID, call the `technology` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Shopify\"]`.\n\nA product name the technology list knows matches that product and its own products (`\"Salesforce\"` also matches Salesforce Desk and Salesforce Service Cloud), never look-alikes; other text matches by similarity."},"wantedly_url":{"type":"string","description":"Wantedly profile URL for the company."},"youtrust_url":{"type":"string","description":"YOUTRUST profile URL for the company."},"founded_dates":{"type":"array","items":{"type":"integer"},"example":[2018,2024],"description":"Years of company founded range. The maximum value founded is the current year."},"job_locations":{"type":"array","items":{"type":"string"},"example":["US","SG","CN"],"description":"ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out `location` endpoints under the Filters tab for more information."},"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/`"},"exclude_fields":{"type":"array","items":{"type":"string"},"example":["emails","phones","contacts"],"description":"List of fields to exclude from the response payload."},"exclude_places":{"type":"array","items":{"type":"string"},"example":["Tokyo"],"description":"Place names (city, region) to exclude from results. Accepts localized or English place names."},"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*. 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."},"news_categories":{"type":"array","items":{"type":"string"},"example":["launches"],"description":"List of `category slugs` for searching for specific news categories. To find a slug, call the `news categories` endpoint under the Filters tab."},"rocketpunch_url":{"type":"string","description":"RocketPunch profile URL for the company."},"domain_search_id":{"type":"string","description":"Pubrio company identifier."},"job_posted_dates":{"type":"array","items":{"type":"string"},"example":["2025-01-01","2025-01-10"],"description":"Date range of the posted date. The maximum value is the current day. Day boundaries follow your workspace timezone."},"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."},"exclude_locations":{"type":"array","items":{"type":"string"},"example":["CN","US","RU","CA"],"description":"ISO 3166-1 alpha-2 (cca2) is used to filter out locations that does not need to be returned. Check out `location` endpoints under the Filters tab for more information."},"filter_conditions":{"type":"array","items":{"type":"object","properties":{"key":{"enum":["keywords","verticals","vertical_categories","vertical_sub_categories","technologies","categories","social_media","advertisement_target_locations","job_exclude_locations"],"type":"string","example":"keywords","description":"The filter key specifying which property to apply the operator to."},"operator":{"enum":["or","and"],"type":"string","example":"or","description":"The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values."}}},"description":"Advanced filtering options for company searches. Specify conditions combining keys and logical operators to refine search results."},"vertical_categories":{"type":"array","items":{"type":"integer"},"description":"A list of `vertical_category_id` used to search for companies in a specific vertical category. To find the ID, call the `vertical category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Information Technology\"]`."},"news_published_dates":{"type":"array","items":{"type":"string"},"example":["2025-01-01","2025-01-10"],"description":"Date range of the published date. The maximum value is the current day. Day boundaries follow your workspace timezone."},"job_exclude_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["CN","US","RU","CA"],"description":"ISO 3166-1 alpha-2 (cca2) is used to filter out locations that does not need to be returned. Check out `location` endpoints under the Filters tab for more information."}],"description":"Geographic locations to exclude from job posting results."},"advertisement_end_dates":{"type":"array","items":{"type":"string","format":"date"},"example":["2025-12-25","2025-12-25"],"description":"End date range for advertisement filtering."},"vertical_sub_categories":{"type":"array","items":{"type":"integer"},"description":"A list of `vertical_sub_category_id` used to search for companies in a specific vertical sub-category. To find the ID, call the `vertical sub category` endpoint under the Filters tab.\n\nThis filter supports `is_enable_similarity_search`, once enabled you can enter any free text, e.g. `[\"Software\"]`."},"advertisement_start_dates":{"type":"array","items":{"type":"string","format":"date"},"example":["2025-12-25","2025-12-25"],"description":"Start date range for advertisement filtering."},"advertisement_search_terms":{"type":"array","items":{"type":"string"},"example":["asus"],"description":"Keywords used to search within advertisement content or titles."},"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."},"is_profile_metadata_available":{"type":"boolean","description":"Indicates whether profile metadata is available for the request."},"advertisement_target_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["TW","AE","NO"],"description":"Country codes the results must target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."}],"description":"Target geographic locations for advertisements."},"is_parameter_metadata_available":{"type":"boolean","description":"Indicates whether parameter metadata is available for the request."},"advertisement_exclude_target_locations":{"allOf":[{"type":"array","items":{"type":"string"},"example":["IS","GB","FR","IE","ES"],"description":"Country codes the results must not target. Combines with `filter_conditions` as OR by default — a result matches if it targets any of them."}],"description":"Geographic locations to exclude from advertisement targeting."}},"description":"Provide at least one of the following: domain_search_id (domain_search_id); domain (domain); linkedin_url (linkedin_url); tiktok_url (tiktok_url); wantedly_url (wantedly_url); tw104_url (tw104_url); rocketpunch_url (rocketpunch_url); remember_url (remember_url); youtrust_url (youtrust_url)."},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"},"description":"The similar companies, each with a `similarity_score`. This endpoint returns a bare array — unlike the other search endpoints, there is no `pagination` wrapper inside `data`. Page with `page` and `per_page`."},"metadata":{"type":"object","description":"Request context. Carries the echoed `filters` and `parameters`, and a `profile` block with `credit`, `topup_credit` and `total_credit_cost` — the only per-call credit accounting the API returns."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_pb4aLGat_-joMRJmjglsF","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.pubrio.com","brandSlug":"agents-pubrio-com-x402","brandBaseUrl":"https://agents.pubrio.com","brandDocsUrl":null,"whatItDoes":"Find companies similar to a given reference company, ranked by similarity score, using a domain, LinkedIn URL, or other identifier.","exampleAgentPrompt":"Can you find companies similar to Stripe using their domain stripe.com, filtered to fintech and AI keywords, and show me the first page of results?","exampleUseCases":[{"title":"Competitive landscape discovery for sales","prompt":"Find me companies similar to HubSpot using hubspot.com as the reference — I want to see the top lookalikes so I can build a list of competitors to target with our sales outreach."},{"title":"Investor lookalike research by LinkedIn URL","prompt":"I'm researching investment opportunities — can you find companies similar to this LinkedIn page linkedin.com/company/notion so I can discover comparable startups in the productivity space?"},{"title":"Market expansion lead generation in Tokyo","prompt":"We want to expand into Japan — can you find companies similar to pubrio.com but filter the results to companies based in Tokyo so we can identify local market peers?"}],"resultDescription":"An array of company objects each containing profile data and a similarity_score between 0 and 1 indicating how closely each company resembles the reference, along with metadata including echoed filters, request parameters, and per-call credit usage (credit, topup_credit, total_credit_cost).","failureModes":["HTTP 416 if page or per_page exceeds subscription limits (max_search_page or max_search_per_page)","Error if more than one singular identifier is supplied simultaneously","Invalid or unresolvable domain/URL returns no results or an error","Expired or insufficient credits result in an authorization or payment error","Malformed URL inputs may be auto-converted or rejected depending on format"],"whenToPreferThis":"Use this endpoint when you need to discover companies that are similar or analogous to a known reference company — ideal for competitive intelligence, sales prospecting, investor research, or market mapping. Prefer it over general company search when you have a specific anchor company and want ranked lookalikes with similarity scores rather than keyword-driven results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:03.496Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-pubrio-similar-company-search-4ce14585"}