来自替代数据组的实用程序库
altdg的Python项目详细描述
AltDG API Python工具
命令行工具,其中包含批量使用AltDG API的方法。在
)Alternative Data Group。版权所有。在
目录
要求
Python 3.6+
See also requirements.txt
安装
在shell中运行以下命令:
# install as usual python package pip install altdg # ... or install "altdg" package directly from repo pip install git+https://github.com/altdg/bulk_mapper.git # ... or if you want to get samples for testing, clone the repo git clone https://github.com/altdg/bulk_mapper.git altdg pip install -e altdg
现在一切都准备好运行这个工具了。在
授权
要使用此工具,您必须具有AltDG API的有效应用程序密钥。 方法的可用性取决于您使用AltDG的帐户类型。在
自由层密钥
使用此键免费尝试API:f816b912549069f7f2e3b1cc60659f0
在https://developer.altdg.com/注册以获得非试用密钥。在
使用
运行该工具的首选方法是使用python
命令将其作为模块加载。在
运行带有--help
标志的工具以显示命令的用法:
域映射器
将域名从给定文本映射到结构化的公司信息。在
More details in https://developer.altdg.com/docs#domain-mapper
这将运行提供的文本文件中的所有域(预期每行一个域):
altdg -e domain-mapper sample-domains.txt -k "f816b9125492069f7f2e3b1cc60659f0"
在https://developer.altdg.com/注册以获得非试用密钥。在
CSV输出文件将自动创建,路径与输入文件相同,但在当前日期之前加上。在
sample-domains.txt是我们在回购中包含的域的示例列表。此文件作为此包的一部分下载,无需重新创建。在
商户映射器
将交易性购买文本(例如信用卡交易)中的字符串映射到结构化公司信息。在
More details in https://developer.altdg.com/docs#merchant-mapper
altdg -e merchant-mapper sample-merchants.txt -k "f816b9125492069f7f2e3b1cc60659f0"
在https://developer.altdg.com/注册以获得非试用密钥。在
CSV输出文件将自动创建,路径与输入文件相同,但在当前日期之前加上。在
sample-merchants.txt是我们在回购中包含的域的示例列表。此文件不需要重新下载,因此不需要重新创建此文件包。在
映射器产品
将产品相关文本(例如库存)中的字符串映射到结构化的公司信息。在
More details in https://developer.altdg.com/docs#product-mapper
altdg -e product-mapper sample-products.txt -k "f816b9125492069f7f2e3b1cc60659f0"
在https://developer.altdg.com/注册以获得非试用密钥。在
CSV输出文件将自动创建,路径与输入文件相同,但在当前日期之前加上。在
命令参数(选项)
参数:
-e <endpoint>
--endpoint
映射器的类型。可选择“商家映射器”、“域映射器”和“产品映射器”。在-k <key>
--key
AltDG API应用程序密钥。在-o <filename>
--out
输出文件路径。如果未提供,则输入文件名将与“.csv”扩展名一起使用,并在前面加上日期和时间。在-F
--force
当提供一个特定的输出文件时,该文件中可能已经存在一些输入结果。 使用此选项可强制重新处理输出文件中已存在的结果,否则将存在 不会再次处理结果。不会覆盖以前的结果,会添加一个新的CSV行。在-n
--num-threads
要并行处理的请求数。(请参见--help
了解最大值和默认值)-r
--num-retires
每个请求的重试次数。(请参见--help
了解最大值和默认值)-t
--timeout
API请求超时(秒)。(请参见--help
了解最大值和默认值)-th <hint>
--type-hint
通过提供行业名称或与输入相关的任何关键字提示来提高准确性。E、 g.-th "medical"
用作库
您可以使用python程序中的AltdgAPI
类:
fromaltdg.apiimportAltdgAPI# initialize Mapper class with your keymapper=AltdgAPI('domain-mapper',api_key='f816b9125492069f7f2e3b1cc60659f0')# single queryprint(mapper.query('abc.com'))# single query with hintprint(mapper.query('abc.com',hint='news'))# bulk queryprint(mapper.bulk_query(['yahoo.com','amazon.com']))# bulk query with same hint for all inputsprint(mapper.bulk_query(['yahoo.com','amazon.com'],hint='company'))# bulk query with overwriting hintprint(mapper.bulk_query([('purple mint','restaurant'),# (input, hint) tuple'amazon',# just input with base hint],hint='company'))# base hint
支持
如果您需要直接与我们联系,请发送电子邮件info@altdg.com。在
- 项目
标签: