立即注册

Geeksend.com API

介绍
认证

电子邮箱查找器

电子邮箱验证器

用户账户

GEEKSEND API

用户可以通过 Geeksend API 来使用 Geeksend 功能。集成 Geeksend API 可同步潜在客户、查找邮箱地址以及管理潜在客户等。
Geeksend API 的速率限制为每分钟 60 个请求。
免费用户若要测试 API 功能，可直接通过在线客服或service@geeksend.com联系我们，无需升级套餐。

认证

您需要生成访问口令来确认之后的请求。发出请求时，请在“Authorization”字段中指定此访问口令

Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4

以上即为生成的口令示例。

请求
 https://open.geeksend.com/oauth/access_token
输入参数
grant_type将始终是client_credentials
client_id您的 ID 在帐户设置中可用 https://app.geeksend.com/account/api
client_secret您的密钥在帐户设置中可用 https://app.geeksend.com/account/api
代码示例
def get_access_token():
    params = {
        'grant_type':'client_credentials',
        'client_id':'client_id',#your client_id
        'client_secret': 'client_secret' #your client_secret
    }

    res = requests.post('https://open.geeksend.com/oauth/access_token', data=params)
    token = res.json()["data"]["access_token"]
    return token
回执示例
{'code': 1, 'info': 'success', 'data': {'access_token': 'your access_token', 'expire_in': 3600}}
输出参数
access_token您的新访问口令
token_type将始终是 Bearer
expires_in口令到期时间（秒）

电子邮箱查找器

POST域名搜索

每10个邮箱地址 1个积分；1个潜在客户 1个积分

输入域名：geeksend.com， 将返回该域名上的所有邮箱地址。
如果数据库中存有关于邮箱所有者的任何其他信息，我们也会将其添加进来。
每次响应最多返回 100 个邮箱地址或100个潜在客户。
每10个邮箱地址，扣除1个积分（不满10按照10计算）；每1个潜在客户，扣除1个积分。
如果没有返回邮箱地址或潜在客户，则不会向您收取该请求的费用。
 

请求
POST https://open.geeksend.com/search/domain_emails_with_info
输入参数
domain是您要从中查询电子邮箱地址的域名名称。例如：geeksend.com
type它包含不同的值 - all 、personal 或 generic。通用的电子邮箱地址是基于职务的电子邮箱地址，例如 - contact@geeksend.com.
个人的电子邮箱地址是在公司工作的实际人员的电子邮箱地址。
limit设置返回的电子邮箱地址的数量限制。每次响应最多返回100个电子邮箱地址。
lastId若要收集的邮箱地址数量超过您在“limit”输入参数中设置的数量，请您在下一个请求中输入上一个请求中最后收集的邮箱地址 ID。这样，系统将跳过之前收集过的邮箱。
请注意，lastId 是必填参数。
默认值为 0。
positions使用此参数过滤潜在客户的职位，例如：“Software Developer”。如需过滤多个职务，请输入一些必要的职位名称
 
代码示例
def get_domain_search():
    token = get_access_token()
    headers = {
        "Authorization":f"Bearer {token}"
    }
    params = {
      'domain': 'geeksend.com',
      'type': 'all',
      'limit': 100,
      'lastId': 0,
    }
    res = requests.post('https://open.geeksend.com/search/domain_emails_with_info',headers=headers,data=params)
    print(res.json())
回执示例
{'success': True, 'domain': 'huawei.com', 'result': 100, 'lastId': 17268170, 'limit': 100, 'companyName': 'huawei technologies', 'emails': [{'email': 'pascal.sallin@huawei.com', 'type': 'personal', 'status': 'valid'}]}
输出参数
domainAPI 已为其提供电子邮箱地址的域名。
limit指定要返回的电子邮箱地址的最大数量。
companyName用于查找电子邮箱地址的公司名称。
emails在搜索中检索到的域名电子邮箱的数组。
email在搜索中检索到的特定电子邮箱地址。
type包含prospect 或 email值。如果返回类型为 prospect，则Geeksend.com已找到有关邮箱地址所有者的其他信息。
status电子邮箱的验证状态。电子邮箱的状态可以是verified 或 notVerified.
firstName邮箱地址所有者的名字。
lastName邮箱地址所有者的姓氏。
position邮箱地址所有者的当前职位。
sourcePage检索到的个人数据的源页面。
lastId上一个回执中最后收集到的邮箱地址ID。

POST邮箱地址数量

免费

通过API的方式，您可以在我们的数据库中查询到某个域名下的邮箱地址数量，此功能完全免费，无需支付积分。

请求
POST https://open.geeksend.com/search/get_domain_emails_count
输入参数
domain您想知道我们数据库中邮箱地址数量的域名名称。
代码示例
def get_email_count():
    token = get_access_token()
    headers = {
        "Authorization":f"Bearer {token}"
    }
    params = {
        'domain':'octagon.com'
    }
    res = requests.post('https://open.geeksend.com/search/get_domain_emails_count',headers=headers, data=params)
    print(res.json())
回执示例
{'success': True, 'domain': 'octagon.com', 'result': 417}
输出参数
domain您想知道我们数据库中邮箱地址数量的域名的名称。
result我们已找到该域名下的电子邮箱地址的数量。如果我们无法提供该域名的结果，则该域的结果始终是0 .

POST电子邮箱查找器

每个请求 1个积分

通过API可按照名字和姓氏以及域名来查找邮箱地址。如果我们的数据库中不存在此电子邮箱地址，我们将无法立即为您提供结果。

请求
POST https://open.geeksend.com/search/get_emails_from_names
输入参数
firstName邮箱地址所有者的名字。
lastName邮箱地址所有者的姓氏。
domain邮箱地址中使用的公司的域名。
代码示例
def get_email_finder():
    token = get_access_token()
    headers = {
        "Authorization":f"Bearer {token}"
    }
    params = {
        'domain':'broadcom.com',
        'firstName': 'Junn',
        'lastName':'Dai'
    }
    res = requests.post('https://open.geeksend.com/search/get_emails_from_names',headers=headers,data=params)
    print(res.json())
回执示例
{'success': True, 'params': {'firstName': 'Junn', 'lastName': 'Dai', 'domain': 'broadcom.com'}, 'data': {'firstName': 'Junn', 'lastName': 'Dai', 'emails': []}, 'status': {'identifier': 'not_found', 'description': 'Emails search is completed'}}
输出参数
status使用此对象中的值来检测流程的状态。
identifier可能包含以下值：complete ,in_progress , 或 not_found 。如果标识符为 not_found ，回执将包含一个没有邮箱地址的数组。
description在这里，您将看到有关邮箱地址查找状态的文字说明。
data包含搜索结果。
firstName邮箱地址所有者的名字。
lastName邮箱地址所有者的姓氏。
emails邮箱地址及其状态的数组。值emailStatus可能包含：valid 或unknown .

POST通过网址获取潜在客户

每个请求 1个积分

通过您输入的潜在客户的社交网址，Geeksend会返回潜在客户的完整信息以及找到的邮箱地址。该方法的前提是您需要拥有潜在客户的社交网址，否则将不会显示结果。

 

请求
POST https://open.geeksend.com/search/get_emails_from_url
输入参数
url潜在客户社交媒体资料的链接。在(括号)中指定社交网络的名称(领英或X) 。
代码示例
def get_emails_from_url():
    token = get_access_token()
    headers = {
        "Authorization":f"Bearer {token}"
    }
    params = {
        'url':'https://www.linkedin.com/in/elie-ohayon-aaab7341'
    }
    res = requests.post('https://open.geeksend.com/search/get_emails_from_url', headers=headers, data=params)
    print(res.json())
回执示例
{'success': True, 'data': [{'id': '5ROWrA2X', 'name': 'Elie Ohayon', 'firstName': 'elie', 'lastName': 'ohayon', 'sourcePage': 'https://www.linkedin.com/in/elie-ohayon-aaab7341', 'source': 'linkedin', 'industry': '', 'country': '', 'locality': 'Paris, Île-de-france, France', 'lastUpdateDate': {'date': '1970-01-01 08:00:00', 'timezone_type': 3, 'timezone': 'UTC'}, 'currentJob': [{'companyName': '', 'position': '', 'socialLink': '', 'site': '', 'locality': '', 'state': '', 'city': '', 'street': '', 'street2': '', 'postal': '', 'founded': '', 'startDate': '', 'endDate': None, 'size': '', 'industry': '', 'companyType': '', 'country': ''}], 'previousJob': [], 'social': None, 'emails': [{'email': 'ohayon.elie@gmail.com', 'emailStatus': 'unknown'}]}]}
输出参数
success是 true如果已经找到潜在客户
id唯一的配置文件标识符
name潜在客户全名
firstName潜在客户名字
lastName潜在客户姓氏
industry潜在客户资料中显示的行业
country潜在客户所在国家
locality潜在客户所在地点
skills潜在客户技能
social潜在客户的社交资料链接
currentJobs数组包含有关潜在客户当前职务的信息
previousJobs数组包含有关潜在客户以前职务的信息
lastUpdateDate上次资料更新日期
emails潜在客户的邮箱地址（包含实际状态）

POST获取含有邮箱地址的社交账户资料

每个请求 1个积分

当您提供一个邮箱地址时，Geeksend 会从数据库中返回与该邮箱地址所有者相关的所有配置文件信息。若我们在数据库中未能找到有关该邮箱地址所有者的信息，那么此次请求将不会向您收取费用。

请求
POST https://open.geeksend.com/search/get_profile_by_email
输入参数
email您想要查找其他信息的人的邮箱地址。
代码示例
def get_profile_by_email():
    token = get_access_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    params = {
        'email':'syeda.zehra@ttc.ca'
    }

    res = requests.post('https://open.geeksend.com/search/get_profile_by_email', headers=headers, data=params)
    print(res.json())
回执示例
{'success': True, 'id': 'DyExGRgL', 'source': 'linkedin', 'name': 'Syeda Zehra', 'firstName': 'syeda', 'lastName': 'zehra', 'industry': None, 'country': 'Canada', 'locality': 'Toronto, Ontario, Canada', 'social': [{'type': 'linkedin', 'link': 'https://linkedin.com/in/syeda-zehra-6b60655a'}], 'currentJobs': {'companyName': 'ttc', 'position': '', 'socialLink': 'https://linkedin.com/company/ttc', 'site': 'http://www.ttc.ca', 'locality': 'Toronto', 'state': 'Canada', 'city': 'toronto', 'street': '', 'street2': '', 'postal': '', 'founded': '1921', 'startDate': '', 'endDate': None, 'size': '10,001+', 'industry': 'Urban Transit Services', 'companyType': '', 'country': 'Canada'}, 'previousJobs': [], 'lastUpdateDate': '1970-01-01 08:00:00'}
输出参数
id唯一的配置文件标识符。
source检索到的个人数据的来源。
name邮箱地址所有者的全名。
firstName此人的名字。
lastName此人的姓氏。
logo此人的资料照片。
industry来源中显示的此人所在行业。
country来源中显示的此人所在国家/地区。
locality来源中显示的此人所在地点。
social到此人社交资料链接。
currentJobs包含有关此人当前工作职位信息的数组。
previousJobs一个包含有关此人以前工作职位信息的数组。
lastUpdateDate数据库中最后一份资料的更新日期。

电子邮箱验证器

POST电子邮箱验证器

免费

该方法可以检查您所提供的邮箱地址是否有效。API 端点会返回邮箱地址的验证结果。若我们之前未曾验证过某个邮箱地址，那么结果将不会反馈给您。在此情况下，API 将返回 “not_verified” 标识符，并且不会向您收取积分。此时，您应使用 “添加邮箱地址用于验证” 方法推送此邮箱地址进行验证，之后您便能够使用此端点获取邮箱地址的验证结果。

请求
POST https://open.geeksend.com/verify/get_emails_verification_status
输入参数
emails您需要验证的邮箱地址。
代码示例
def get_email_verifier():
    token = get_access_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    params = {
        'emails': ['gavin.vanrooyen@octagon.com','lizi.hamer@octagon.com'],
    }
    res = requests.post('https://open.geeksend.com/verify/get_emails_verification_status',headers=headers, data=params)
    print(res.json())
回执示例
{'success': True, 'results': [{'status': {'identifier': 'complete', 'description': 'Verification completed'}, 'data': {'email': 'lizi.hamer@octagon.com', 'sendStatus': 'unknown', 'smtpStatus': 'valid', 'isCatchall': False, 'isGreylist': True, 'isBannedError': False, 'isConnectionError': False, 'isBusinessEmail': False, 'isValidFormat': True, 'isWebmail': False, 'isDisposable': False, 'isCompanyEmail': False, 'isGibberish': False}}, {'status': {'identifier': 'complete', 'description': 'Verification completed'}, 'data': {'email': 'lizi.hamer@octagon.com', 'sendStatus': 'unknown', 'smtpStatus': 'valid', 'isCatchall': False, 'isGreylist': True, 'isBannedError': True, 'isConnectionError': False, 'isBusinessEmail': False, 'isValidFormat': True, 'isWebmail': False, 'isDisposable': False, 'isCompanyEmail': False, 'isGibberish': False}}]}
输出参数
status邮箱地址验证状态。包含标识符和描述。
identifier可以包含以下值：complete ,in_progress , 或 not_verified . 如果标识符为 not_verified ,data 将为空。

 


我们只对验证结果为有效和无效的邮箱地址进行扣费，验证结果为无法验证的则不收取您的费用。

POST添加邮箱地址用于验证

每验证 1 个邮箱地址消耗 1 个积分

如果您以前从未验证过某个邮箱地址，则应使用此 API 方法将其推送以进行验证。执行此操作后，您可以使用“电子邮箱验证器”获得验证结果。

请求
POST https://open.geeksend.com/verify/add_emails_to_verification
输入参数
emails您需要添加到验证队列的邮箱地址列表。每个请求最多可以包含 10 个邮箱地址。
代码示例
def add_emails_for_verification():
    token = get_access_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    params = {
        'emails': ['gavin.vanrooyen@octagon.com','lizi.hamer@octagon.com'],
    }
    res = requests.post('https://open.geeksend.com/verify/add_emails_to_verification',headers=headers, data=params)
    print(res.json())
回执示例
{"success":true}

如果将邮箱地址成功添加到队列中，则该方法返回 {"success":true}

用户账户

POST查看用户余额

免费

用此方法查看您的积分余额。

 

请求
POST http://open.geeksend.com/account/balance
代码示例
def get_balance():
    token = get_access_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    res = requests.post('https://open.geeksend.com/account/balance',headers=headers)
    print(res.json())
回执示例
{'success': True, 'data': {'balance': 5009, 'teamwork': False, 'unique_recipients_used': 10100, 'limit_resets_in': 27, 'expires_in': 27}}
输出参数
balance用户当前的信用点数余额。
teamwork若您目前是团队成员或领导，则为“true”，若您不属于任何团队，则为“false”。
recipients_used本月已使用的唯一收件人数量。
limit_resets_in距离限额重置的天数。
expires_in距离订阅结束的天数。