# Pubrio People Contact Redemption

> Pubrio People Contact Redemption is a paid API for AI agents from agents.pubrio.com, paid per call via MPP or x402, $0.15/call, status healthy (last checked 2026-10-12, last successful call 2026-10-09).

Spend credits to unlock verified email addresses (work/personal) and phone numbers for a specific person identified by LinkedIn URL or Pubrio search ID.

## Facts

- Endpoint: POST https://agents.pubrio.com/redeem/people?utm_source=zero.xyz
- Price: $0.15/call
- Payment: MPP, x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-09
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 36
- Provider: agents.pubrio.com
- Website: https://agents.pubrio.com
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-pubrio-com-pubrio-people-contact-redemption-d9a86afc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ks4cSbPxn_p1o3gmkaupo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-pubrio-com-pubrio-people-contact-redemption-d9a86afc -d '<json body>'
```

Example prompt: Can you unlock the work email and phone number for the LinkedIn profile at https://www.linkedin.com/in/jane-smith-123456 using Pubrio credits? I need both email-work and phone contact types.

## When to prefer this

Use this endpoint when you have already identified a specific person (via Pubrio search or LinkedIn URL) and need to unlock their actual contact details (email, phone) for outreach. This is the credit-spending step after discovery. Prefer this over re-searching when you already have a people_search_id or LinkedIn URL in hand. Not suitable for bulk/batch contact enrichment — use per-person after targeted lookup.

## Known failure modes

- Misspelled contact type slugs (e.g. 'work_email' instead of 'email-work') return HTTP 200 with emails: null, phones: null, total_credit_cost: 0 — indistinguishable from a person with no contact data
- Person has no contact data on record — returns null for emails and/or phones with cost 0
- Invalid or unresolvable LinkedIn URL returns an error or empty result
- Insufficient credits to complete the redemption
- Missing both people_search_id and linkedin_url causes a validation error
- UUID format required for people_search_id — malformed IDs will fail

## How this service works

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.

## Output

Returns a 'peoples' array with the redeemed contact data: 'emails' (null if none found) and 'phones' (null if none found) for the matched person, plus a 'profile' object showing current credit balance, topup credit, and total_credit_cost of the redemption. Credit cost is 0 if no contact data was matched; cost scales with the number of contact types requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "anyOf": [
  {
   "title": "People Search ID",
   "required": [
    "people_search_id",
    "people_contact_types"
   ]
  },
  {
   "title": "LinkedIn URL",
   "required": [
    "linkedin_url",
    "people_contact_types"
   ]
  }
 ],
 "properties": {
  "person_id": {
   "type": "string"
  },
  "linkedin_url": {
   "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_search_id": {
   "type": "string",
   "format": "uuid",
   "description": "A unique identifier for the people search operation."
  },
  "people_contact_types": {
   "type": "array",
   "items": {
    "enum": [
     "email-work",
     "email-personal",
     "phone"
    ],
    "type": "string"
   },
   "example": [
    "email-work",
    "email-personal",
    "phone"
   ],
   "description": "Which contact details to redeem. Use exactly `email-work`, `email-personal` and/or `phone` — resolve the live list from the `people contact type` endpoint under the Filters tab.\n\n**Unrecognised values are not rejected.** A misspelling such as `work_email` returns HTTP 200 with `emails: null`, `phones: null` and `total_credit_cost: 0` — identical to a person genuinely having no contact data. If redemptions look universally empty, check these slugs first."
  }
 },
 "description": "Provide at least one of the following: People Search ID (people_search_id, people_contact_types); LinkedIn URL (linkedin_url, people_contact_types)."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "allOf": [
    {
     "type": "object",
     "nullable": true,
     "description": "Response info depends on specific endpoint."
    }
   ],
   "nullable": true,
   "properties": {
    "peoples": {
     "type": "array",
     "items": {
      "type": "object"
     },
     "description": "The redeemed people. `emails` and `phones` are `null` — not `[]` — when nothing is found for that person, so guard before iterating. `total_credit_cost` reflects only successful matches and is `0` when nothing was redeemed; cost scales with how many contact types you request."
    },
    "profile": {
     "type": "object",
     "properties": {
      "credit": {
       "type": "integer"
      },
      "topup_credit": {
       "type": "integer"
      },
      "total_credit_cost": {
       "type": "integer"
      }
     }
    }
   },
   "description": "Response info depends on specific endpoint."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-pubrio-com-pubrio-people-contact-redemption-d9a86afc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.pubrio.com](https://www.zero.xyz/host/agents.pubrio.com/llms.txt)
