API de IVA de BuiltWith

Uso de crédito API

Necesitas acceso o inscribirse para utilizar la API BuiltWith. Después de iniciar sesión, su clave API real se mostrará aquí.

Introducción

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.

Autenticación

Debe proporcionar su clave API en cada búsqueda. Nuestros puntos finales son solo HTTPS, lo que proporciona cifrado de clave. Nunca exponga su clave API.

Su clave API es
00000000-0000-0000-0000-000000000000

Puede proporcionar su clave como un parámetro de cadena de consulta o como un encabezado HTTP:

  • Cadena de consulta: ?KEY=00000000-0000-0000-0000-000000000000
  • encabezado HTTP: Authorization: API 00000000-0000-0000-0000-000000000000
Ejemplos prácticos

JSON Obtenga los números de registro de la empresa para BuiltWith
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

XML Obtenga los números de registro de la empresa para BuiltWith
https://api.builtwith.com/vat1/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

CSV Obtenga los números de registro de la empresa para BuiltWith
https://api.builtwith.com/vat1/api.csv?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Obtenga números de registro de empresa para múltiples dominios.
https://api.builtwith.com/vat1/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=example.com,builtwith.com

Respuesta

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

Tipos de registro de empresas

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.

TipoNombreDescripción
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.
Referencia de 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.
Dominios especiales

Mantenemos dos listas útiles para la búsqueda de dominios: listas de ignorados y listas de sufijos incorporados.

Lista de ignorados
TEsta es nuestra lista interna de dominios que no indexamos. Están bloqueados, contienen demasiadas tecnologías engañosas o demasiados subdominios con contenido generado por el usuario.

BuiltWith Lista de sufijos
Esto se basa en la Lista de sufijos públicos pero incluye muchas entradas adicionales para empresas con subdominios que deberían considerarse dominios de nivel superior. Esta lista nos proporciona una mejor visibilidad para los sitios web internos, por ejemplo, lleva a northernbeaches.nsw.gov.au al nivel superior sobre nsw.gov.au.

Ignorar dominios (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
Dominios de sufijo (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
Códigos de error

Tenga en cuenta que no se pueden garantizar los mensajes de error en este formato; su implementación también debe considerar los códigos de respuesta distintos de 200 como errores. La propiedad Lookup será nula (json) o no se proporcionará (xml) si el error está relacionado con el servidor. Ver todos los posibles códigos de error bien formados.

Condiciones de uso

Nuestro términos estándar cubrir el uso de todas nuestras API.

En general, puede usar la API para mejorar su producto de diversas maneras. La única limitación es que no puede revender los datos tal cual ni proporcionar funcionalidad duplicada a builtwith.com y sus servicios asociados.