Skip to main content
POST
/
redeem
/
people
/
contact
/
lookup
/
batch
Bulk-look up people by contact identifier
curl --request POST \
  --url https://api.pubrio.com/redeem/people/contact/lookup/batch \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "peoples": [
    {
      "email": "[email protected]"
    },
    {
      "first_name": "John",
      "last_name": "Smith",
      "domain": "example.com"
    }
  ],
  "is_enable_similarity_search": true,
  "profile_id": 123
}
'
{
  "data": {
    "profile": {
      "credit": 450374,
      "topup_credit": 235236,
      "total_credit_cost": 2
    },
    "peoples": [
      {
        "people_search_id": "e37ccf38-ea8f-422e-9874-cb23b15e8fe4",
        "people_name": "King Lai",
        "company_name": "Pubrio",
        "domain": "pubrio.com",
        "match": {
          "confidence": "exact",
          "input": {
            "value": "[email protected]",
            "type": "email-work"
          },
          "is_duplicate_input": false
        }
      },
      {
        "people_search_id": "1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b",
        "people_name": "John Smith",
        "company_name": "Example",
        "domain": "example.com",
        "match": {
          "confidence": "similarity_domain",
          "input": {
            "value": "example.com",
            "type": "domain"
          },
          "is_duplicate_input": false
        }
      }
    ]
  }
}

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.

Authorizations

​
pubrio-api-key
string
header
required

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 section.

Body

application/json
​
peoples
object[]
required

Array of lookup specs. Each entry accepts the same identifiers as the single-lookup body (email, phone, or first_name + last_name + domain/company when similarity search is enabled). Capped by your subscription's bulk size limit.

Example:
[
  { "email": "[email protected]" },
  {
    "first_name": "John",
    "last_name": "Smith",
    "domain": "example.com"
  }
]
​
is_enable_similarity_search
boolean
default:false

When true, falls back to a name-based similarity match if no exact email/phone hit is found. Requires first_name, last_name, and either domain or company.

Example:

true

​
profile_id
integer

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.

Response

Successful response containing matched people and per-record match metadata.

​
data
object

Response info depends on specific endpoint.