Api Endpoint

Pubrio

Returns people similar to a reference person, LinkedIn profile or job title, each with a similarity score from 0 to 1, narrowed by people and company filters. 25 per page. Each call is 3 credits.

Open interactive test console

Offering

Provider
agents.pubrio.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Business And Commerce
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://agents.pubrio.com/people/search/similar
MIME type
Not provided
First seen
2026-10-16T01:52:52.778Z
Last seen
Tags
market expansion, sales intelligence, company data, people data, lead enrichment

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0xa330fbe0cdcf75e09b2f1c94c108be5aba31e322"
  }
]

Observed health

Status
Reachable
Latest latency
247 ms
Average latency
415 ms
HTTP status
400
Last checked
Reachability
100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "anyOf": [
        {
          "required": [
            "peoples"
          ]
        },
        {
          "required": [
            "people_search_id"
          ]
        },
        {
          "required": [
            "people_titles"
          ]
        },
        {
          "required": [
            "linkedin_url"
          ]
        },
        {
          "required": [
            "linkedin_urls"
          ]
        }
      ],
      "example": {
        "people_locations": [
          "SG"
        ],
        "people_titles": [
          "head of growth"
        ],
        "per_page": 5
      },
      "properties": {
        "companies": {
          "description": "A list of unique identifiers (domain_search_id) used for company and people search operations.",
          "items": {
            "format": "uuid",
            "type": "string"
          },
          "type": "array"
        },
        "company_filters": {
          "description": "Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*.",
          "example": {
            "company_locations": [
              "US"
            ],
            "filter_conditions": [
              {
                "key": "technologies",
                "operator": "and"
              }
            ],
            "founded_dates": [
              2015,
              2023
            ],
            "technologies": [
              37,
              152
            ]
          },
          "type": "object"
        },
        "company_linkedin_urls": {
          "description": "The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/",
          "example": [
            "https://www.linkedin.com/company/pubrio"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "company_locations": {
          "description": "The location of the company headquarters.",
          "example": [
            "US",
            "SG",
            "CN"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "department_functions": {
          "description": "The filter field for job functions can specify particular roles or areas of expertise when searching for people.",
          "example": [
            "human_resources"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "departments": {
          "description": "The department field can search for people in specific areas of expertise.",
          "example": [
            "master_human_resources"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "domains": {
          "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.",
          "example": [
            "pubrio.com"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "employees": {
          "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.",
          "example": [
            [
              1,
              10
            ],
            [
              11,
              20
            ],
            [
              10001
            ]
          ],
          "items": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "type": "array"
        },
        "filter_conditions": {
          "description": "Per-key AND/OR override for filters in /people/search. Defaults to OR when omitted.",
          "items": {
            "properties": {
              "key": {
                "description": "The filter key specifying which property to apply the operator to.",
                "enum": [
                  "keywords",
                  "verticals",
                  "vertical_categories",
                  "vertical_sub_categories",
                  "technologies",
                  "categories",
                  "social_media"
                ],
                "example": "technologies",
                "type": "string"
              },
              "operator": {
                "description": "The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values.",
                "enum": [
                  "or",
                  "and"
                ],
                "example": "and",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "is_enable_similarity_search": {
          "description": "When enabled, the filters listed above that support similarity searches can be filled with free text for specific IDs.",
          "type": "boolean"
        },
        "linkedin_url": {
          "description": "A single LinkedIn profile URL to use as the reference.",
          "type": "string"
        },
        "linkedin_urls": {
          "description": "The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/",
          "example": [
            "http://www.linkedin.com/in/king-lai-605382b7"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "management_levels": {
          "description": "Reporting tier of the person. The C-suite slug is c_suite, not c_level. An unknown slug matches nobody.",
          "example": [
            "c_suite",
            "vp"
          ],
          "items": {
            "enum": [
              "c_suite",
              "director",
              "entry",
              "founder",
              "head",
              "intern",
              "manager",
              "owner",
              "partner",
              "senior",
              "vp"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "page": {
          "default": 1,
          "description": "Page number, starting at 1.",
          "example": 1,
          "type": "integer"
        },
        "people_locations": {
          "description": "The location where people live.",
          "example": [
            "US",
            "SG",
            "CN"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "people_name": {
          "description": "Filter search results to include a specific people name.",
          "example": "king",
          "type": "string"
        },
        "people_search_id": {
          "description": "Pubrio person id to use as the reference.",
          "type": "string"
        },
        "people_titles": {
          "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.",
          "example": [
            "sales manager",
            "marketing manager"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "peoples": {
          "description": "A list of unique identifiers (people_search_id) used for people search operations.",
          "items": {
            "format": "uuid",
            "type": "string"
          },
          "type": "array"
        },
        "per_page": {
          "default": 25,
          "description": "Records per page, 1 to 25. Defaults to 25.",
          "example": 25,
          "maximum": 25,
          "type": "integer"
        },
        "search_term": {
          "description": "A string of words over which we want to filter the results.",
          "example": "pubrio",
          "type": "string"
        },
        "similarity_score": {
          "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.",
          "example": 0.7,
          "format": "float",
          "type": "number"
        }
      },
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "anyOf": [
            {
              "required": [
                "peoples"
              ]
            },
            {
              "required": [
                "people_search_id"
              ]
            },
            {
              "required": [
                "people_titles"
              ]
            },
            {
              "required": [
                "linkedin_url"
              ]
            },
            {
              "required": [
                "linkedin_urls"
              ]
            }
          ],
          "example": {
            "people_locations": [
              "SG"
            ],
            "people_titles": [
              "head of growth"
            ],
            "per_page": 5
          },
          "properties": {
            "companies": {
              "description": "A list of unique identifiers (domain_search_id) used for company and people search operations.",
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "type": "array"
            },
            "company_filters": {
              "description": "Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*.",
              "example": {
                "company_locations": [
                  "US"
                ],
                "filter_conditions": [
                  {
                    "key": "technologies",
                    "operator": "and"
                  }
                ],
                "founded_dates": [
                  2015,
                  2023
                ],
                "technologies": [
                  37,
                  152
                ]
              },
              "type": "object"
            },
            "company_linkedin_urls": {
              "description": "The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/",
              "example": [
                "https://www.linkedin.com/company/pubrio"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "company_locations": {
              "description": "The location of the company headquarters.",
              "example": [
                "US",
                "SG",
                "CN"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "department_functions": {
              "description": "The filter field for job functions can specify particular roles or areas of expertise when searching for people.",
              "example": [
                "human_resources"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "departments": {
              "description": "The department field can search for people in specific areas of expertise.",
              "example": [
                "master_human_resources"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "domains": {
              "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.",
              "example": [
                "pubrio.com"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "employees": {
              "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.",
              "example": [
                [
                  1,
                  10
                ],
                [
                  11,
                  20
                ],
                [
                  10001
                ]
              ],
              "items": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": "array"
            },
            "filter_conditions": {
              "description": "Per-key AND/OR override for filters in /people/search. Defaults to OR when omitted.",
              "items": {
                "properties": {
                  "key": {
                    "description": "The filter key specifying which property to apply the operator to.",
                    "enum": [
                      "keywords",
                      "verticals",
                      "vertical_categories",
                      "vertical_sub_categories",
                      "technologies",
                      "categories",
                      "social_media"
                    ],
                    "example": "technologies",
                    "type": "string"
                  },
                  "operator": {
                    "description": "The logical operator to apply. Use 'or' to match any of the specified values, or 'and' to require all specified values.",
                    "enum": [
                      "or",
                      "and"
                    ],
                    "example": "and",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "is_enable_similarity_search": {
              "description": "When enabled, the filters listed above that support similarity searches can be filled with free text for specific IDs.",
              "type": "boolean"
            },
            "linkedin_url": {
              "description": "A single LinkedIn profile URL to use as the reference.",
              "type": "string"
            },
            "linkedin_urls": {
              "description": "The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/",
              "example": [
                "http://www.linkedin.com/in/king-lai-605382b7"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "management_levels": {
              "description": "Reporting tier of the person. The C-suite slug is c_suite, not c_level. An unknown slug matches nobody.",
              "example": [
                "c_suite",
                "vp"
              ],
              "items": {
                "enum": [
                  "c_suite",
                  "director",
                  "entry",
                  "founder",
                  "head",
                  "intern",
                  "manager",
                  "owner",
                  "partner",
                  "senior",
                  "vp"
                ],
                "type": "string"
              },
              "type": "array"
            },
            "page": {
              "default": 1,
              "description": "Page number, starting at 1.",
              "example": 1,
              "type": "integer"
            },
            "people_locations": {
              "description": "The location where people live.",
              "example": [
                "US",
                "SG",
                "CN"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "people_name": {
              "description": "Filter search results to include a specific people name.",
              "example": "king",
              "type": "string"
            },
            "people_search_id": {
              "description": "Pubrio person id to use as the reference.",
              "type": "string"
            },
            "people_titles": {
              "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.",
              "example": [
                "sales manager",
                "marketing manager"
              ],
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "peoples": {
              "description": "A list of unique identifiers (people_search_id) used for people search operations.",
              "items": {
                "format": "uuid",
                "type": "string"
              },
              "type": "array"
            },
            "per_page": {
              "default": 25,
              "description": "Records per page, 1 to 25. Defaults to 25.",
              "example": 25,
              "maximum": 25,
              "type": "integer"
            },
            "search_term": {
              "description": "A string of words over which we want to filter the results.",
              "example": "pubrio",
              "type": "string"
            },
            "similarity_score": {
              "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.",
              "example": 0.7,
              "format": "float",
              "type": "number"
            }
          },
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}