Utilisation du crédit API

Vous devez se connecter ou s'inscrire pour utiliser l'API BuiltWith. Après vous être connecté, votre clé API actuelle sera affichée ici.

Introduction

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.

Authentification

Vous devez fournir votre clé API à chaque recherche. Nos points de terminaison sont exclusivement HTTPS, ce qui assure le chiffrement des clés. N'exposez jamais votre clé API.

Votre clé API est
00000000-0000-0000-0000-000000000000

Vous pouvez fournir votre clé en tant que paramètre de chaîne de requête ou en tant qu'en-tête HTTP :

  • chaîne de requête: ?KEY=00000000-0000-0000-0000-000000000000
  • En-tête HTTP: Authorization: API 00000000-0000-0000-0000-000000000000
Exemples de travail

JSON Obtenez les numéros d'enregistrement de l'entreprise BuiltWith
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

XML Obtenez les numéros d'enregistrement de l'entreprise BuiltWith
https://api.builtwith.com/vat1/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

CSV Obtenez les numéros d'enregistrement de l'entreprise BuiltWith
https://api.builtwith.com/vat1/api.csv?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Obtenez les numéros d'enregistrement d'entreprise pour plusieurs domaines
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=example.com,builtwith.com

Réponse

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

Types d'enregistrement d'entreprise

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.

TaperNomDescription
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.
Référence de l'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.
Domaines spéciaux

Nous tenons à votre disposition deux listes utiles pour la recherche de domaines : les listes « Ignorer » et les listes « Construire avec un suffixe ».

Liste d'ignorés
TVoici notre liste interne de domaines que nous n'indexons pas. Ils sont soit bloqués, soit contiennent trop de technologies trompeuses, soit trop de sous-domaines avec du contenu généré par les utilisateurs.

BuiltWith Liste des suffixes
Ceci est basé sur le Liste publique des suffixes mais comprend de nombreuses entrées supplémentaires pour les entreprises avec des sous-domaines qui doivent être considérés comme des domaines de premier niveau. Cette liste nous offre une meilleure visibilité pour les sites Web internes, par exemple, elle amène northernbeaches.nsw.gov.au au niveau supérieur par rapport à nsw.gov.au.

Ignorer les domaines (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
Domaines de suffixe (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
Codes d'erreur

Notez que les messages d'erreur dans ce format ne peuvent pas être garantis, votre implémentation doit également considérer les codes de réponse non 200 comme des erreurs. La propriété Lookup sera nulle (json) ou non fournie (xml) si l'erreur est liée au serveur. Afficher tous les codes d'erreur potentiels bien formés.

Conditions d'utilisation

Notre conditions générales couvrir l'utilisation de toutes nos API.

En général, vous pouvez utiliser l'API pour améliorer votre produit de nombreuses façons. La seule limitation est que vous ne pouvez pas revendre les données en l'état ni fournir des fonctionnalités dupliquées à builtwith.com et ses services associés.