{"uid":"cap_2a4o8LWjfxtdTbNgsFtf3","slug":"agents-pubrio-com-bulk-look-up-people-by-contact-identifier-581e30f3","name":"Bulk Look Up People by Contact Identifier","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/redeem/people/contact/lookup/batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["peoples"],"properties":{"peoples":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email"},"phone":{"type":"string"},"domain":{"type":"string"},"company":{"type":"string"},"last_name":{"type":"string"},"first_name":{"type":"string"}}},"example":[{"email":"king.lai@pubrio.com"},{"domain":"example.com","last_name":"Smith","first_name":"John"}],"description":"Array of lookup specs. Each entry takes `email`, `phone`, or `first_name` + `last_name` + `domain`/`company`, the same as the single-lookup body. Capped by your subscription's bulk size limit. A request where no entry has any of these is refused with `400`."},"person_ids":{"type":"array","items":{"type":"string"}},"is_enable_similarity_search":{"type":"boolean","default":false,"example":true,"description":"Only changes rows that have an `email` or `phone`. When `true`, a row whose email or phone finds nobody is then searched by name (`first_name`, `last_name`, and `domain` or `company`). A row with only a name and a company is always searched by name and does not need this."}}},"responseSchema":{"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."}},"description":"Response info depends on specific endpoint."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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":{"amountUsd":"0.02","asset":"USDC"},"pricing":{"kind":"session","summary":"$0.02/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact","depositUsd":"0.02"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact","depositUsd":"0.02"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_RbmHpyw0sBIrSHNW0rbHI","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":20000,"planRef":null},{"uid":"pm_IoFM1PbN2s0xY6s5fEgRa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_-jckLu5q1JPRp-ptvvwsH","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":"Batch-resolve up to the subscription's limit of people records from emails, phones, or name+company pairs in a single request, charging 1 credit per matched result.","exampleAgentPrompt":"Look up contact records for all these people at once — I have a mix of emails like king.lai@pubrio.com and name+domain pairs like John Smith at example.com — and use similarity search as a fallback if an email doesn't find anyone directly.","exampleUseCases":[{"title":"Sales lead list enrichment","prompt":"I have a list of 50 leads with emails and some just have first name, last name, and company domain — can you batch look them all up in Pubrio and get me their verified work emails and phone numbers?"},{"title":"CRM contact data backfill","prompt":"We need to enrich our CRM contacts — here are 200 entries with a mix of email addresses and name+company pairs. Run them all through Pubrio's bulk contact lookup and pull back whatever verified contact info is available."},{"title":"Event attendee contact resolution","prompt":"I've got a list of event registrants — some rows have emails, others only have first name, last name, and company. Batch look them up using Pubrio and enable similarity search so name+company rows get matched even if the email doesn't hit."}],"resultDescription":"Returns an array of person records (one per input entry) under `data.peoples`. Each record includes available verified emails and phone numbers (returned as `null`, not an empty array, when nothing is found). The `total_credit_cost` field reflects only successful matches; unmatched and duplicate entries are not charged.","failureModes":["400 Bad Request if no entry in `peoples` contains at least one of: email, phone, or first_name+last_name+(domain or company)","400 if the number of entries exceeds the subscription's bulk size limit","Unmatched entries return null for emails and phones — must guard against null before iterating","Duplicate inputs (same email, phone, or name+company as a prior request) are not charged and may return cached results","Missing or expired credentials result in 401 Unauthorized"],"whenToPreferThis":"Use this endpoint when you need to resolve contact details for multiple people at once and want to avoid the overhead and latency of sequential single-lookup calls. It is the right choice when your input list contains a mix of identifier types (email, phone, name+company) and you want efficient credit usage — duplicates and unmatched entries are never charged. Prefer the single-lookup endpoint only when resolving one person at a time in real-time interactive flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:43:50.891Z","isFirstParty":false,"canonicalSlug":"agents-pubrio-com-bulk-look-up-people-by-contact-identifier-581e30f3"}