Deeplead
Find local businesses, companies and decision makers with verified emails for B2B outreach.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (2)
- LOWTool 'credits_get' description lacks action verben credits_get
- LOWTool 'organizations_find_decision_maker' name length outside 3-30 rangeen organizations_find_decision_maker
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~7,216Tokens (definiciones de herramientas)
~6.9 KBTamaño de respuesta típico
Impacto significativo en la atención (5.64% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"deeplead": {
"url": "https://www.deeplead.io/api/mcp"
}
}
}Puntos de conexión remotos
https://www.deeplead.io/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (11)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟡businesses_search(niches, location, page, radiusMiles, keyword, ...)
Search local businesses from Google Business Profiles. 23M+ businesses with ratings, reviews, website contacts, socials and ad pixels. 30 per page. Charges 1 credit per business with an email or phone and 0.5 per business without. saveToContacts also stores them in your contacts. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"niches": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Google categories or plain niches, e.g. [\"dentist\"]"
},
"location": {
"type": "string",
"minLength": 1,
"description": "A city (\"Austin, TX\"), a US state (\"Texas\") or a country (\"Germany\")"
},
"page": {
"default": 1,
"description": "Page number, starting at 1; up to 30 businesses per page",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"radiusMiles": {
"description": "Around a city; default 30",
"type": "number",
"minimum": 1,
"maximum": 100
},
"keyword": {
"description": "Matched against the business name and categories",
"type": "string"
},
"excludedNiches": {
"description": "Business categories or niches to exclude",
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"description": "Google rating band to match",
"type": "string",
"enum": [
"under-4",
"4-to-4.5",
"4.5-plus"
]
},
"reviews": {
"description": "Google review-count band to match",
"type": "string",
"enum": [
"under-10",
"10-to-100",
"100-plus"
]
},
"require": {
"description": "e.g. { \"email\": true, \"metaAds\": false }; false matches only businesses checked and found without it",
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"metaAds",
"googleAds",
"chatgptAds",
"gAnalytics",
"tiktokPixel",
"claimed",
"website",
"email",
"phone"
]
},
"additionalProperties": {
"type": "boolean"
}
},
"saveToContacts": {
"default": false,
"description": "Save returned businesses to your Deeplead contacts",
"type": "boolean"
}
},
"required": [
"niches",
"location"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"chargedCredits": {
"type": "number"
},
"businesses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"businessId": {
"type": "string"
},
"name": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"type": [
"number",
"null"
]
},
"reviewCount": {
"type": [
"number",
"null"
]
},
"reviewsByStars": {
"type": "array",
"items": {
"type": [
"number",
"null"
]
},
"description": "Counts of 1 to 5 star reviews"
},
"googleProfileClaimed": {
"type": [
"boolean",
"null"
]
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"tiktok"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false
}
},
"required": [
"businessId",
"name",
"categories",
"address",
"city",
"country",
"website",
"email",
"emails",
"phone",
"phones",
"rating",
"reviewCount",
"reviewsByStars",
"googleProfileClaimed",
"socials",
"adPixels"
],
"additionalProperties": false
}
}
},
"required": [
"chargedCredits",
"businesses"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_search(query, semantic, domains, hqCountry, hqState, ...)
Search organizations, or look them up by domain. Charges 0.5 credits per returned organization. limit 0 returns only totalCount, free. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Free text matched against company name, description and keywords",
"type": "string",
"minLength": 1
},
"semantic": {
"description": "What the company is and sells, matched by meaning, e.g. \"outsourced medical billing for clinics\"",
"type": "string",
"minLength": 1
},
"domains": {
"description": "Look companies up by domain, e.g. [\"stripe.com\"]",
"maxItems": 100,
"type": "array",
"items": {
"type": "string"
}
},
"hqCountry": {
"description": "ISO alpha-2 country codes of the headquarters, e.g. [\"US\", \"DE\"]",
"type": "array",
"items": {
"type": "string"
}
},
"hqState": {
"description": "US state names or codes of the headquarters",
"type": "array",
"items": {
"type": "string"
}
},
"employeeBands": {
"description": "Headcount bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1,000",
"1,001-5,000",
"5,001-10,000",
"10,001+"
]
}
},
"revenueRange": {
"description": "Annual company revenue bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"<$1M",
"$1M to <$10M",
"$10M to <$50M",
"$50M to <$100M",
"$100M to <$1B",
"$1B+"
]
}
},
"industryNaicsDirect": {
"description": "NAICS codes",
"type": "array",
"items": {
"type": "string"
}
},
"technologies": {
"description": "Technologies used by the company",
"type": "array",
"items": {
"type": "string"
}
},
"foundedAfter": {
"description": "Earliest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"foundedBefore": {
"description": "Latest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monthlyVisitsMin": {
"description": "Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"employeeGrowthMin": {
"description": "Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fundedAfter": {
"description": "Year of the last funding round, at least; known for about 1 in 100 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"hqCity": {
"description": "City names of the headquarters, e.g. [\"Austin\"]",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"default": 25,
"description": "Maximum companies to return; 0 returns only a free count",
"type": "integer",
"minimum": 0,
"maximum": 25
},
"offset": {
"default": 0,
"description": "Number of matching companies to skip for pagination",
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"includeWithoutWebsite": {
"default": false,
"description": "Include companies without websites in search results",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"totalCount": {
"type": "number"
},
"chargedCredits": {
"type": "number"
},
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"organizationId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"websiteAlive": {
"type": [
"boolean",
"null"
]
},
"websiteTitle": {
"type": [
"string",
"null"
]
},
"websiteDescription": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"linkedinDescription": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"keywords": {
"type": [
"string",
"null"
]
},
"technologies": {
"type": [
"string",
"null"
]
},
"employeeCount": {
"type": [
"number",
"null"
]
},
"employeeMin": {
"type": [
"number",
"null"
]
},
"employeeMax": {
"type": [
"number",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"monthlyVisits": {
"description": "Estimated monthly website visits",
"type": [
"number",
"null"
]
},
"monthlyGoogleAdSpend": {
"description": "Estimated monthly Google Ads spend in USD",
"type": [
"number",
"null"
]
},
"employeeGrowthRate": {
"description": "Employee growth on LinkedIn in percent",
"type": [
"number",
"null"
]
},
"lastFunding": {
"type": "object",
"properties": {
"type": {
"description": "e.g. Seed Round, Series A, Private Equity Round",
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"amount": {
"description": "USD",
"type": [
"number",
"null"
]
}
},
"required": [
"type",
"date",
"amount"
],
"additionalProperties": false
},
"totalFunding": {
"description": "USD",
"type": [
"number",
"null"
]
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"hqCity": {
"type": [
"string",
"null"
]
},
"hqState": {
"type": [
"string",
"null"
]
},
"hqCountry": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"x": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"x",
"tiktok",
"youtube"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false,
"description": "true/false where the website was checked, null where it never was"
}
},
"required": [
"organizationId",
"name",
"domain",
"website",
"websiteAlive",
"websiteTitle",
"websiteDescription",
"linkedin",
"linkedinDescription",
"description",
"industry",
"naicsCodes",
"keywords",
"technologies",
"employeeCount",
"employeeMin",
"employeeMax",
"revenueRange",
"monthlyVisits",
"monthlyGoogleAdSpend",
"employeeGrowthRate",
"lastFunding",
"totalFunding",
"foundedYear",
"hqCity",
"hqState",
"hqCountry",
"emails",
"phones",
"socials",
"adPixels"
],
"additionalProperties": false
}
}
},
"required": [
"totalCount",
"chargedCredits",
"organizations"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_enrich(domain)
Enrich a company from its domain. Returns the company's firmographics, socials and website data. Charges 0.5 credits only when the company is found. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"minLength": 3,
"description": "Company domain or website URL, e.g. \"stripe.com\""
}
},
"required": [
"domain"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"organization": {
"anyOf": [
{
"type": "object",
"properties": {
"organizationId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"websiteAlive": {
"type": [
"boolean",
"null"
]
},
"websiteTitle": {
"type": [
"string",
"null"
]
},
"websiteDescription": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"linkedinDescription": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"keywords": {
"type": [
"string",
"null"
]
},
"technologies": {
"type": [
"string",
"null"
]
},
"employeeCount": {
"type": [
"number",
"null"
]
},
"employeeMin": {
"type": [
"number",
"null"
]
},
"employeeMax": {
"type": [
"number",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"monthlyVisits": {
"description": "Estimated monthly website visits",
"type": [
"number",
"null"
]
},
"monthlyGoogleAdSpend": {
"description": "Estimated monthly Google Ads spend in USD",
"type": [
"number",
"null"
]
},
"employeeGrowthRate": {
"description": "Employee growth on LinkedIn in percent",
"type": [
"number",
"null"
]
},
"lastFunding": {
"type": "object",
"properties": {
"type": {
"description": "e.g. Seed Round, Series A, Private Equity Round",
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"amount": {
"description": "USD",
"type": [
"number",
"null"
]
}
},
"required": [
"type",
"date",
"amount"
],
"additionalProperties": false
},
"totalFunding": {
"description": "USD",
"type": [
"number",
"null"
]
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"hqCity": {
"type": [
"string",
"null"
]
},
"hqState": {
"type": [
"string",
"null"
]
},
"hqCountry": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"x": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"x",
"tiktok",
"youtube"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false,
"description": "true/false where the website was checked, null where it never was"
}
},
"required": [
"organizationId",
"name",
"domain",
"website",
"websiteAlive",
"websiteTitle",
"websiteDescription",
"linkedin",
"linkedinDescription",
"description",
"industry",
"naicsCodes",
"keywords",
"technologies",
"employeeCount",
"employeeMin",
"employeeMax",
"revenueRange",
"monthlyVisits",
"monthlyGoogleAdSpend",
"employeeGrowthRate",
"lastFunding",
"totalFunding",
"foundedYear",
"hqCity",
"hqState",
"hqCountry",
"emails",
"phones",
"socials",
"adPixels"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"chargedCredits",
"organization"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_find_decision_maker(organizationId)
Find the decision maker of an organization with a verified email. Charges 2 credits only when a decision maker is found. Can take a few minutes. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"minLength": 1,
"description": "Company ID returned by organization search or enrichment"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"decisionMaker": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"position": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"name",
"position",
"linkedin",
"email"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"creditsCharged",
"decisionMaker"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_search(query, semantic, domains, hqCountry, hqState, ...)
Search persons with their emails and phones. Returns only people with an email or phone, with full contact data, and charges 1 credit per returned person. Page with nextOffset. limit 0 returns only totalCount, free. saveToContacts also stores them in your contacts, where people you already had are refunded. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Free text matched against company name, description and keywords",
"type": "string",
"minLength": 1
},
"semantic": {
"description": "What the company is and sells, matched by meaning, e.g. \"outsourced medical billing for clinics\"",
"type": "string",
"minLength": 1
},
"domains": {
"description": "Look companies up by domain, e.g. [\"stripe.com\"]",
"maxItems": 100,
"type": "array",
"items": {
"type": "string"
}
},
"hqCountry": {
"description": "ISO alpha-2 country codes of the headquarters, e.g. [\"US\", \"DE\"]",
"type": "array",
"items": {
"type": "string"
}
},
"hqState": {
"description": "US state names or codes of the headquarters",
"type": "array",
"items": {
"type": "string"
}
},
"employeeBands": {
"description": "Headcount bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1,000",
"1,001-5,000",
"5,001-10,000",
"10,001+"
]
}
},
"revenueRange": {
"description": "Annual company revenue bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"<$1M",
"$1M to <$10M",
"$10M to <$50M",
"$50M to <$100M",
"$100M to <$1B",
"$1B+"
]
}
},
"industryNaicsDirect": {
"description": "NAICS codes",
"type": "array",
"items": {
"type": "string"
}
},
"technologies": {
"description": "Technologies used by the company",
"type": "array",
"items": {
"type": "string"
}
},
"foundedAfter": {
"description": "Earliest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"foundedBefore": {
"description": "Latest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monthlyVisitsMin": {
"description": "Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"employeeGrowthMin": {
"description": "Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fundedAfter": {
"description": "Year of the last funding round, at least; known for about 1 in 100 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"jobTitle": {
"description": "Matched as partial text, so \"CEO\" also finds \"Assistant to the CEO\"; combine with jobLevel to narrow",
"type": "array",
"items": {
"type": "string"
}
},
"jobTitleExclude": {
"description": "Job title phrases to exclude",
"type": "array",
"items": {
"type": "string"
}
},
"jobLevel": {
"description": "Allowed job seniority levels",
"type": "array",
"items": {
"type": "string",
"enum": [
"C-Team",
"VP",
"Director",
"Manager",
"Staff",
"Other"
]
}
},
"decisionMakersOnly": {
"description": "C-level, VP or director seniority, or a founder, owner, CEO, managing director or president title",
"type": "boolean"
},
"inCountry": {
"description": "ISO alpha-2 country codes where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"personState": {
"description": "States where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"personCity": {
"description": "Cities where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"organizationIds": {
"description": "Limit to organizations from /organizations/search",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"default": 25,
"description": "Maximum people to return; 0 returns only a free count",
"type": "integer",
"minimum": 0,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Pagination offset; use nextOffset from the previous response",
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"onePerOrganization": {
"default": false,
"description": "Return at most one person per company",
"type": "boolean"
},
"saveToContacts": {
"default": false,
"description": "Save returned people to your Deeplead contacts",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"totalCount": {
"type": "number",
"description": "With limit 0: all matching people, including those without an email or phone"
},
"nextOffset": {
"type": [
"number",
"null"
]
},
"chargedCredits": {
"type": "number"
},
"persons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"personId": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"linkedin": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"jobLevel": {
"type": [
"string",
"null"
]
},
"jobFunction": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"companyMonthlyVisits": {
"type": [
"number",
"null"
]
},
"companyEmployeeGrowthRate": {
"description": "Percent",
"type": [
"number",
"null"
]
},
"companyLastFundingType": {
"type": [
"string",
"null"
]
},
"companyLastFundingDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"personId",
"name",
"email",
"alternateEmails",
"phone",
"phones",
"linkedin",
"jobTitle",
"jobLevel",
"jobFunction",
"city",
"state",
"country",
"organizationId",
"companyName",
"companyWebsite",
"revenueRange",
"naicsCodes",
"foundedYear",
"companyMonthlyVisits",
"companyEmployeeGrowthRate",
"companyLastFundingType",
"companyLastFundingDate"
],
"additionalProperties": false
}
}
},
"required": [
"totalCount",
"nextOffset",
"chargedCredits",
"persons"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_lookup(linkedin, email, name, domain, saveToContacts)
Look up one person by LinkedIn URL, email, or name and company domain. Returns the person with their emails, phones, role and company. Charges 1 credit only when the person is found with an email or phone. saveToContacts also stores them in your contacts. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"email": {
"description": "Known email address identifying the person",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
},
"saveToContacts": {
"default": false,
"description": "Save the returned person to your Deeplead contacts",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"person": {
"anyOf": [
{
"type": "object",
"properties": {
"personId": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"linkedin": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"jobLevel": {
"type": [
"string",
"null"
]
},
"jobFunction": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"companyMonthlyVisits": {
"type": [
"number",
"null"
]
},
"companyEmployeeGrowthRate": {
"description": "Percent",
"type": [
"number",
"null"
]
},
"companyLastFundingType": {
"type": [
"string",
"null"
]
},
"companyLastFundingDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"personId",
"name",
"email",
"alternateEmails",
"phone",
"phones",
"linkedin",
"jobTitle",
"jobLevel",
"jobFunction",
"city",
"state",
"country",
"organizationId",
"companyName",
"companyWebsite",
"revenueRange",
"naicsCodes",
"foundedYear",
"companyMonthlyVisits",
"companyEmployeeGrowthRate",
"companyLastFundingType",
"companyLastFundingDate"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"chargedCredits",
"person"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_find_email(linkedin, name, domain)
Find a person's work email by LinkedIn URL, or full name and company domain. Charges 1 credit only when an email is found. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
}
},
"required": [
"found",
"chargedCredits",
"email",
"alternateEmails",
"name",
"jobTitle",
"companyName",
"companyWebsite",
"linkedin"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_find_phone(linkedin, email, name, domain)
Find a person's phone number by LinkedIn URL, email, or full name and company domain. Charges 2 credits only when a phone number is found. Send an Idempotency-Key header to make retries safe.
Esquema de entrada
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"email": {
"description": "Known email address identifying the person",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
}
},
"required": [
"found",
"chargedCredits",
"phone",
"phones",
"name",
"jobTitle",
"companyName",
"companyWebsite",
"linkedin"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡contacts_create(contacts)
Save your own contacts or organizations. Free. Existing contacts are matched and kept, never duplicated.
Esquema de entrada
{
"type": "object",
"properties": {
"contacts": {
"minItems": 1,
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"personName": {
"type": "string"
},
"position": {
"type": "string"
},
"businessName": {
"type": "string"
},
"website": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"phone": {
"type": "string"
},
"city": {
"type": "string"
},
"industry": {
"type": "string"
},
"organizationId": {
"description": "From /organizations/search",
"type": "string"
}
}
},
"description": "Contacts to save; each needs an email, LinkedIn URL, website or organization ID"
}
},
"required": [
"contacts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"saved": {
"type": "number"
}
},
"required": [
"saved"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢contacts_list(limit, before)
List your contacts in a stable order; page with nextBefore
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"default": 100,
"description": "Maximum saved contacts to return on this page",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"before": {
"description": "The nextBefore of the previous page",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contactId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
}
},
"required": [
"contactId",
"name",
"email",
"jobTitle",
"companyName",
"website",
"linkedin",
"organizationId"
],
"additionalProperties": false
}
},
"nextBefore": {
"type": [
"string",
"null"
]
}
},
"required": [
"contacts",
"nextBefore"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢credits_get
Current credit balance
Esquema de entrada
{
"type": "object",
"properties": {}
}Esquema de salida
{
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada11 herramientas