API 信用使用情况

你需要 登录 或者 报名 使用 BuiltWith API. 登录后,您的实际 API 密钥将显示在这里。

介绍

The VAT API returns VAT, GSTIN, CNPJ, ABN and other available company registration numbers for websites.

This is particularly useful for products that accept business signups or payments and need company registration details to help determine how tax should be charged. For example, a billing or checkout workflow can look up the domain from a customer's business email or website, identify an available VAT or local registration number, and use it to pre-fill tax fields, reduce signup friction, flag accounts for tax review, or support business-to-business tax handling.

The data can also help enrich customer records, distinguish businesses from consumers, reconcile company details, and prioritize cases where registration information should be confirmed. Registration data should be verified with the appropriate official tax authority before it is relied upon for tax calculation, exemption, invoicing, or compliance decisions.

Each domain that returns one or more registration records uses one API credit. Domains with no registration results do not use a credit. You can look up between 1 and 16 comma-separated root domains in one request.

验证

每次查询时,您都必须提供 API 密钥。我们的端点仅支持 HTTPS,并提供密钥加密。 永远不要暴露您的 API 密钥。

您的 API 密钥是
00000000-0000-0000-0000-000000000000

您可以将密钥作为查询字符串参数或 HTTP 标头提供:

  • 查询字符串: ?KEY=00000000-0000-0000-0000-000000000000
  • HTTP 标头: Authorization: API 00000000-0000-0000-0000-000000000000
工作示例

JSON 获取 BuiltWith 的公司注册号
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

XML 获取 BuiltWith 的公司注册号
https://api.builtwith.com/vat1/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

CSV 获取 BuiltWith 的公司注册号
https://api.builtwith.com/vat1/api.csv?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON 获取多个域名的公司注册号
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=example.com,builtwith.com

回复

Results are flat records containing Domain, Type and Number. A domain can return more than one record. Domains without known registration data return no records.

[
  { "Domain": "builtwith.com", "Type": "GSTIN", "Number": "2332323" }
]

CSV responses contain the same values:

Domain,Type,Number
builtwith.com,GSTIN,2332323

公司注册类型

The public registration-types endpoint lists every value that may appear in the VAT API Type field, together with its friendly name and description. It does not require an API key or use API credits.

https://api.builtwith.com/vat1/types.json

XML and CSV are also available at /vat1/types.xml and /vat1/types.csv.

类型姓名描述
ABNABNAustralian Business Number issued by the ATO, an 11-digit identifier for entities carrying on business in Australia.
ACNACNAustralian Company Number issued by ASIC, a 9-digit identifier assigned to every registered Australian company.
AFMAFMGreek tax registration number (Arithmos Forologikou Mitroou), a 9-digit identifier assigned by the tax authority.
BCEBCEBelgian Crossroads Bank for Enterprises number, a 10-digit identifier for companies registered in Belgium.
BNBusiness No.Canadian Business Number issued by the CRA, a 9-digit identifier that may include a 4-digit program account suffix.
BRNBusiness Reg. No.South Korean Business Registration Number issued by the NTS, formatted as XXX-XX-XXXXX.
CEGJEGYZEKSZAMCompany Reg. No.Hungarian company registration number (Cégjegyzékszám) held in the company register, formatted as XX-XX-XXXXXX.
CIFCIFSpanish tax identification number (Código de Identificación Fiscal) for legal entities, beginning with a letter followed by 8 alphanumeric characters.
CINCINIndian Corporate Identity Number issued by the MCA, a 21-character alphanumeric code identifying every registered company.
CNPJCNPJBrazilian company registration number (Cadastro Nacional da Pessoa Jurídica) issued by the Receita Federal, consisting of 14 digits.
CRNCompany Reg. No.UK Companies House registration number, typically 5–8 digits with an optional prefix such as SC (Scotland) or NI (Northern Ireland).
CROCRO No.Irish Companies Registration Office number, a 5–6 digit identifier assigned to companies registered in Ireland.
CUICUIRomanian Unique Registration Code (Cod Unic de Înregistrare), a fiscal identifier prefixed with RO assigned to companies by the tax authority.
CVRCVRDanish Central Business Register number (CVR-nummer), an 8-digit identifier for all registered businesses in Denmark.
DICDICCzech or Slovak tax identification number (Daňové identifikační číslo), an 8–10 digit code optionally prefixed with a country code.
EINEINUS Employer Identification Number issued by the IRS, formatted as XX-XXXXXXX and used for federal tax purposes.
FBNFBNAustrian commercial register number (Firmenbuchnummer), consisting of 4–6 digits followed by a check letter.
GEMIGEMIGreek General Electronic Commercial Registry number (ΓΕΜΗ), an 8–12 digit identifier for companies registered in Greece.
GSTINGSTINIndian Goods and Services Tax Identification Number, a 15-character alphanumeric code linking a business to its GST obligations.
HRBHRBGerman commercial register number (Handelsregisternummer), consisting of a HR prefix, letter, and number recorded at the local court.
ICOICOCzech or Slovak company identification number (Identifikační číslo osoby), an 8-digit code assigned by the business register.
JP_CORPORATE_NUMBERJP Corporate No.Japanese corporate number (法人番号), a 13-digit identifier assigned by the National Tax Agency to every registered legal entity.
KRSKRSPolish National Court Register number (Krajowy Rejestr Sądowy), a 10-digit identifier for companies registered in Poland.
KVKKVKDutch Chamber of Commerce number (Kamer van Koophandel), an 8-digit identifier assigned to businesses registered in the Netherlands.
NIPNIPPolish tax identification number (Numer Identyfikacji Podatkowej), a 10-digit code used for tax and VAT purposes.
NIPCNIPCPortuguese company tax identification number (Número de Identificação de Pessoa Coletiva), a 9-digit code assigned by the tax authority.
ORGNROrg. No.Scandinavian organisation number used in Sweden (6+4 digits) and Norway (9 digits) to identify registered legal entities.
PIVAP. IVAItalian VAT number (Partita IVA), an 11-digit identifier assigned to businesses liable for VAT in Italy.
RCSRCSLuxembourg Trade and Companies Register number (Registre de Commerce et des Sociétés), beginning with a letter followed by up to 6 digits.
REGCOMReg. Com.Romanian Trade Register number in J-format (e.g. J40/1234/2000), identifying the county, sequence, and year of registration.
REGONREGONPolish statistical identification number (Rejestr Gospodarki Narodowej), either 9 or 14 digits, assigned by the Central Statistical Office.
RFCRFCMexican Federal Taxpayer Registry code (Registro Federal de Contribuyentes), a 12–13 character alphanumeric identifier for tax purposes.
SIRENSIRENFrench company identifier (Système d'Identification du Répertoire des ENtreprises), a 9-digit code assigned by INSEE.
SIRETSIRETFrench business location identifier (Système d'Identification du Répertoire des ETablissements), a 14-digit code extending the SIREN with an establishment suffix.
UIDUIDSwiss or Austrian company identification number; Swiss UIDs are prefixed CHE with 9 digits, Austrian UIDs are prefixed ATU with 8 digits.
USCCUSCCChinese Unified Social Credit Code (统一社会信用代码), an 18-character alphanumeric identifier assigned to all registered organisations.
USTIDUSt-IdNr.German VAT identification number (Umsatzsteuer-Identifikationsnummer), formatted as DE followed by 9 digits.
VATVATEuropean-style VAT registration number consisting of a 2-letter country prefix followed by up to 18 alphanumeric characters.
YTUNNUSY-tunnusFinnish Business ID (Y-tunnus), a 7-digit number followed by a hyphen and a check digit, assigned by the PRH.
API 参考
  • KEY (required): your BuiltWith API key.
  • LOOKUP (required): 1 to 16 comma-separated domains.
  • Formats: json, xml, and csv.
  • Credit cost: 1 API credit per domain that returns at least one registration record; no credit is used when a domain returns no results.
特殊域名

我们维护两个列表,供您在查找域名时使用。“忽略”列表和“BuiltWith 后缀”列表。

忽略列表
T这是我们内部不予索引的域名列表。这些域名要么被屏蔽,要么包含太多误导性技术,要么包含太多包含用户生成内容的子域名。

BuiltWith 后缀列表
这是基于 公共后缀列表 但对于拥有子域名的公司来说,还包括许多额外的条目,这些子域名应被视为顶级域名。 此列表为我们提供了内部网站的更好可见性,例如,它将 northernbeaches.nsw.gov.au 置于 nsw.gov.au 之上。

忽略域 (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
后缀域 (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
错误代码

请注意,这种格式的错误消息无法保证,您的实现也应该将非 200 响应代码视为错误。 如果错误与服务器相关,则 Lookup 属性将为 null(json)或未提供(xml)。 查看所有潜在的格式正确的错误代码.

使用条款

我们的 标准条款 涵盖我们所有 API 的使用。

一般来说,您可以使用 API 以多种方式增强您的产品。唯一的限制是您不能按原样转售数据,也不能向builtwith.com及其相关服务提供重复的功能。