{
  "url": "https://telipot.com/catalog/capabilities/people.enrich",
  "id": "people.enrich",
  "description": "A person's profile from a name, email or LinkedIn URL",
  "platform": "people",
  "providers": [
    {
      "slug": "hunter",
      "name": "Hunter"
    },
    {
      "slug": "apollo",
      "name": "Apollo"
    }
  ],
  "tasks": 2,
  "taskPages": [
    {
      "id": "hunter.people.enrich",
      "name": "Person profile from an email or LinkedIn handle, with role",
      "provider": {
        "slug": "hunter",
        "name": "Hunter"
      },
      "capability": "people.enrich",
      "platform": "people",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_success",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://help.hunter.io/en/articles/1911617-how-do-credits-work-in-hunter",
        "checked": "2026-10-05",
        "note": "All-in-one plans: 0.2 credit per enriched email or domain. Data Platform plans: 1 Search credit. The credit article does not say whether a 404 (nothing found) or a 451 (person asked not to be processed) is charged; it prices an enriched item, so both are treated as free.",
        "state": "paid",
        "label": "$0.0049 / email",
        "amount": "$0.0049",
        "unit": "email",
        "usdPerUnit": {
          "floor": 0.0049,
          "ceiling": 0.0049
        },
        "native": {
          "text": "0.2 credits per email",
          "figure": "0.2 credits",
          "per": "email",
          "currency": "credits"
        },
        "detail": "0.2 credits · docs"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true,
      "summary": "Returns all the information associated with an email address or LinkedIn handle, such as a person's name, location and social handles.",
      "method": "GET",
      "path": "/people/find",
      "host": "https://api.hunter.io/v2",
      "docsUrl": "https://hunter.io/api-documentation/v2#email-enrichment",
      "auth": {
        "scheme": "api_key",
        "label": "api_key · in header as X-API-KEY",
        "short": "api_key · x-api-key"
      },
      "scope": "any_account",
      "principal": "organization",
      "requiredScopes": [],
      "verification": {
        "state": "untestable",
        "label": "Untestable",
        "detail": "Needs a specific person's email address or LinkedIn handle and answers with that person's name, location, employer and social profiles."
      },
      "input": [
        {
          "name": "email",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Email address to enrich. Give email or linkedin_handle; linkedin_handle wins when both are given."
        },
        {
          "name": "linkedin_handle",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "LinkedIn profile handle to enrich."
        }
      ],
      "sampleInput": {},
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Email address to enrich. Give email or linkedin_handle; linkedin_handle wins when both are given."
          },
          "linkedin_handle": {
            "type": "string",
            "description": "LinkedIn profile handle to enrich."
          }
        },
        "additionalProperties": false
      },
      "output": [
        {
          "name": "data",
          "type": "object"
        },
        {
          "name": "meta",
          "type": "object"
        }
      ],
      "outputSchema": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "id",
              "email"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "object",
                "properties": {
                  "fullName": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "givenName": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "familyName": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "email": {
                "type": "string"
              },
              "location": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "timeZone": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "geo": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "state": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "countryCode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "bio": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "site": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "avatar": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "employment": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "role": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "subRole": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "seniority": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "linkedin": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "twitter": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "github": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              },
              "phone": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "fuzzy": {
                "type": "boolean"
              }
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "email": {
                "type": "string"
              }
            }
          }
        }
      },
      "commands": {
        "mode": "inspect",
        "cli": "telipot inspect hunter.people.enrich",
        "http": "curl https://api.telipot.com/v1/tasks/hunter.people.enrich \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
      },
      "siblings": [
        {
          "id": "apollo.people.enrich",
          "name": "Person's title, work email from email, LinkedIn URL or name",
          "provider": {
            "slug": "apollo",
            "name": "Apollo"
          },
          "capability": "people.enrich",
          "platform": "people",
          "kind": "data",
          "tier": "core",
          "identity": "key",
          "identityLabel": "Your plan",
          "price": {
            "type": "per_success",
            "confidence": "documented",
            "source": "docs",
            "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
            "checked": "2026-10-05",
            "note": "1 credit when credit-consuming data (demographics or email) is found, 0 when none is. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base.",
            "state": "paid",
            "label": "$0.0196 / call",
            "amount": "$0.0196",
            "unit": "call",
            "usdPerUnit": {
              "floor": 0.0196,
              "ceiling": 0.0196
            },
            "native": {
              "text": "1 credit per call",
              "figure": "1 credit",
              "per": "call",
              "currency": "credits"
            },
            "detail": "1 credit · docs"
          },
          "providers": 2,
          "retention": "standard",
          "runsOn": "byoc",
          "live": true
        }
      ]
    },
    {
      "id": "apollo.people.enrich",
      "name": "Person's title, work email from email, LinkedIn URL or name",
      "provider": {
        "slug": "apollo",
        "name": "Apollo"
      },
      "capability": "people.enrich",
      "platform": "people",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_success",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
        "checked": "2026-10-05",
        "note": "1 credit when credit-consuming data (demographics or email) is found, 0 when none is. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base.",
        "state": "paid",
        "label": "$0.0196 / call",
        "amount": "$0.0196",
        "unit": "call",
        "usdPerUnit": {
          "floor": 0.0196,
          "ceiling": 0.0196
        },
        "native": {
          "text": "1 credit per call",
          "figure": "1 credit",
          "per": "call",
          "currency": "credits"
        },
        "detail": "1 credit · docs"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true,
      "summary": "Use the people enrichment endpoint to enrich data for one person.",
      "method": "POST",
      "path": "/people/match",
      "host": "https://api.apollo.io/api/v1",
      "docsUrl": "https://docs.apollo.io/reference/people-enrichment",
      "auth": {
        "scheme": "api_key",
        "label": "api_key · in header as x-api-key",
        "short": "api_key · x-api-key"
      },
      "scope": "any_account",
      "principal": "organization",
      "requiredScopes": [],
      "verification": {
        "state": "untestable",
        "label": "Untestable",
        "detail": "Needs a specific person and answers with that person's profile and work email; a contact lookup, so it has no test request."
      },
      "input": [
        {
          "name": "first_name",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "First name; use with last_name."
        },
        {
          "name": "last_name",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Last name; use with first_name."
        },
        {
          "name": "name",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Full name; replaces first_name and last_name. Identify the person with an email, a LinkedIn URL, an Apollo ID, or a name plus employer domain; a name alone may return a 200 with no match (check match_confidence)."
        },
        {
          "name": "email",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Email address of the person."
        },
        {
          "name": "hashed_email",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "MD5 or SHA-256 hash of the person's email."
        },
        {
          "name": "organization_name",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Name of the person's employer, current or previous."
        },
        {
          "name": "domain",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Domain of the person's employer, current or previous, without www. or @."
        },
        {
          "name": "id",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "Apollo ID of the person, as people search returns it."
        },
        {
          "name": "linkedin_url",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [],
          "note": "URL of the person's LinkedIn profile."
        }
      ],
      "sampleInput": {},
      "inputSchema": {
        "type": "object",
        "properties": {
          "first_name": {
            "type": "string",
            "description": "First name; use with last_name."
          },
          "last_name": {
            "type": "string",
            "description": "Last name; use with first_name."
          },
          "name": {
            "type": "string",
            "description": "Full name; replaces first_name and last_name. Identify the person with an email, a LinkedIn URL, an Apollo ID, or a name plus employer domain; a name alone may return a 200 with no match (check match_confidence)."
          },
          "email": {
            "type": "string",
            "description": "Email address of the person."
          },
          "hashed_email": {
            "type": "string",
            "description": "MD5 or SHA-256 hash of the person's email."
          },
          "organization_name": {
            "type": "string",
            "description": "Name of the person's employer, current or previous."
          },
          "domain": {
            "type": "string",
            "description": "Domain of the person's employer, current or previous, without www. or @.",
            "examples": [
              "apollo.io"
            ]
          },
          "id": {
            "type": "string",
            "description": "Apollo ID of the person, as people search returns it."
          },
          "linkedin_url": {
            "type": "string",
            "description": "URL of the person's LinkedIn profile."
          }
        },
        "additionalProperties": false
      },
      "output": [
        {
          "name": "request_id",
          "type": "integer",
          "description": "Save to map this request to a webhook result; this task sends no webhook."
        },
        {
          "name": "person",
          "type": "object"
        }
      ],
      "outputSchema": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "integer",
            "description": "Save to map this request to a webhook result; this task sends no webhook."
          },
          "person": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "first_name": {
                "type": "string"
              },
              "last_name": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "linkedin_url": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "headline": {
                "type": "string"
              },
              "email": {
                "type": "string"
              },
              "email_status": {
                "type": "string"
              },
              "organization_id": {
                "type": "string"
              },
              "match_confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low",
                  "none"
                ]
              },
              "employment_history": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "organization_id": {
                      "type": "string"
                    },
                    "organization_name": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "start_date": {
                      "type": "string"
                    },
                    "current": {
                      "type": "boolean"
                    }
                  }
                }
              },
              "state": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "seniority": {
                "type": "string"
              },
              "departments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "subdepartments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "functions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "organization": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "website_url": {
                    "type": "string"
                  },
                  "primary_domain": {
                    "type": "string"
                  },
                  "industry": {
                    "type": "string"
                  },
                  "estimated_num_employees": {
                    "type": "integer"
                  }
                }
              }
            }
          }
        }
      },
      "commands": {
        "mode": "inspect",
        "cli": "telipot inspect apollo.people.enrich",
        "http": "curl https://api.telipot.com/v1/tasks/apollo.people.enrich \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\""
      },
      "siblings": [
        {
          "id": "hunter.people.enrich",
          "name": "Person profile from an email or LinkedIn handle, with role",
          "provider": {
            "slug": "hunter",
            "name": "Hunter"
          },
          "capability": "people.enrich",
          "platform": "people",
          "kind": "data",
          "tier": "core",
          "identity": "key",
          "identityLabel": "Your plan",
          "price": {
            "type": "per_success",
            "confidence": "documented",
            "source": "docs",
            "sourceUrl": "https://help.hunter.io/en/articles/1911617-how-do-credits-work-in-hunter",
            "checked": "2026-10-05",
            "note": "All-in-one plans: 0.2 credit per enriched email or domain. Data Platform plans: 1 Search credit. The credit article does not say whether a 404 (nothing found) or a 451 (person asked not to be processed) is charged; it prices an enriched item, so both are treated as free.",
            "state": "paid",
            "label": "$0.0049 / email",
            "amount": "$0.0049",
            "unit": "email",
            "usdPerUnit": {
              "floor": 0.0049,
              "ceiling": 0.0049
            },
            "native": {
              "text": "0.2 credits per email",
              "figure": "0.2 credits",
              "per": "email",
              "currency": "credits"
            },
            "detail": "0.2 credits · docs"
          },
          "providers": 2,
          "retention": "standard",
          "runsOn": "byoc",
          "live": true
        }
      ]
    }
  ]
}