Использование 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 Suffix.

Список игнорирования
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 и связанным с ним сервисам.