Foundry : Developer Portal
HomeHome > News > Foundry : Developer Portal

Foundry : Developer Portal

Dec 05, 2023

If you have any questions, please contact our Support team at [email protected].

Translate IP addresses or domains/websites into company firmographic data.

Convert a domain to the IP address or range of IP addresses owned/used by a company.

Uncover the geolocation of an IP address.

Enrich your API response with customizable first-party data attributes for a target account list.

Provides usage information for any Foundry API endpoint.

This endpoint translates IP addresses or domains/websites into company firmographic data.

Use the interactive interface to build your API query string.

The URL below can be used to call the company endpoint by IP address.Replace [IP-ADDRESS-HERE] with the IP address and [YOUR-API-KEY-HERE] with your API key.

The URL below can be used to call the company endpoint by domain/website.Replace [WEBSITE-HERE] with the domain/website and [YOUR-API-KEY-HERE] with your API key.

The website should NOT include https://, www, page names, or trailing URL data (Example: website.com).

Below is a sample response, in JSON:

Refer to the complete list of responses

This endpoint uncovers the IP address or range of IP addresses owned/used by a company.

Use the interactive interface to build your API query string.

The URL below can be used to call the domain to IP address endpoint.Replace [WEBSITE-HERE] with the website and [YOUR-API-KEY-HERE] with your API key.

Optional Parameters:

Below is a sample response, in JSON:

Refer to the complete list of responses

This endpoint uncovers the geolocation of an IP address.

Use the interactive interface to build your API query string.

The URL below can be used to call the IP Address to Geo Endpoint.Replace [IP-ADDRESS-HERE] with the IP address and [YOUR-API-KEY-HERE] with your API key.

Below is a sample response, in JSON:

Refer to the complete list of responses

This endpoint gives you the ability to personalize your Company API response with first-party data attributes for a specified set of accounts. Custom values can be used to segment, filter, and combine important "known" data.

Use the interactive interface to upload your CSV file and define up to ten custom MyAPI field names. Fields are limited to 255 characters.

The URL below can be used to call the MyAPI endpoint.Replace [YOUR-API-KEY-HERE] with your API key and [YOUR-WEBSITE-HERE] with your website.

Below is a sample response, in JSON:

Refer to the complete list of responses

This endpoint provides usage information for any API endpoint.

Use the interactive interface to build your API query string.

The URL below can be used to call the API Usage endpoint.Replace [YOUR-API-KEY-HERE] with your API key and [YYYY-MM-DD] with the date (Year-Month-Day).

Below is a sample response, in JSON:

Detects an IP address from within a device's DOM (Document Object Model) using jQuery.

Finds the user's country location based on an IP address.

Finds the geolocation of a United States zip code.

Detects the geolocation data based on area code.

Provides a company logo based on website.

Translates company name into website.

Translates the provided domain/website to the top-level domain based on organizational structure/hierarchy.

Provides a list of top-level domains related to the provided domain/website.

The website should not include https://, www, page names, or trailing URL data (Example: website.com)

This endpoint detects an IP address from within a device's DOM (Document Object Model) using jQuery.

The code below can be used to call the IP Address Detection Endpoint.Replace [YOUR-API-KEY-HERE] with your API key.

Call jQuery library inside the HEAD of your document.

This API will return either an IPv4 or IPv6 address. Below is a sample IPv4 response:

This endpoint finds the user's country location based on an IP address.

The URL below can be used to call the IP Address to Country Endpoint.Replace [IP-ADDRESS-HERE] with the IP address and [YOUR-API-KEY-HERE] with your API key.

Below is a sample response, in JSON:

This endpoint finds the geolocation of a United States zip code.

The URL below can be used to call the Zip Code to Geo Endpoint.Replace [YOUR-API-KEY-HERE] with your API key and [ZIP-CODE-HERE] with the 5-digit zip code.

This endpoint is only available for US zip codes.

Below is a sample response, in JSON:

This endpoint detects the geolocation data based on area code.

The URL below can be used to call the Area Code to Geo Endpoint.Replace [YOUR-API-KEY-HERE] with your API key and [YOUR-AREA-CODE-HERE] with the 3-digit area code.

This endpoint is only available for US area codes.

Below is a sample response, in JSON:

This endpoint provides a company logo based on website.

The URL below can be used to call the Company Logo Endpoint.Replace [WEBSITE-HERE] with the website.

Logo size and shape can vary, for this reason we recommend to control the height and width using CSS based on the user needs.

This endpoint translates company name into website.

The URL below can be used to call the Company Name to Website Endpoint.Replace [YOUR-API-KEY-HERE] with your API key and [COMPANY-NAME] with the company name.

Optional Parameters:

Below is a sample response, in JSON:

This endpoint translates the provided domain/website to the top-level domain based on organizational structure/hierarchy.

The URL below can be used to call the Primary Top-Level Domain Website Endpoint.Replace [WEBSITE-HERE] with the website.

Below is a sample response, in JSON:

This endpoint provides a list of top-level domains related to the provided domain/website.

The URL below can be used to call the Related Top-Level Domain Endpoint.Replace [WEBSITE-HERE] with website.

Below is a sample response, in JSON:

Based on ISO 3166 standards

To deliver optimum performance to all of our API customers, KickFire balances transaction loads by using rate limits:

Total API Calls per month determines how many requests can be made to an access point without service interruption or price change. CPQ (Cost Per Query) will allow API queries to be answered, even if the monthly query limit is reached. Each query over the monthly total is charged at the CPQ rate. If the threshold option is selected, the API will return an HTTP 429 ‘Too Many Requests’ response once the threshold is met.

Revenue Ranges:

Employee Ranges:

Refer to the complete list of responses

[IP-ADDRESS-HERE] [YOUR-API-KEY-HERE] [WEBSITE-HERE] [YOUR-API-KEY-HERE] status result data companyName tradeName website street city regionShort region postal countryShort country phone latitude longitude employees revenue sicGroup sicDesc sicCode naicsGroup naicsDesc naicsCode stockSymbol facebook twitter linkedin timeZoneId timeZoneName utcOffset dstOffset confidence isISP isWifi isMobile [WEBSITE-HERE] [YOUR-API-KEY-HERE] Optional Parameters: dotted &dotted=1 page &page=[PAGE] limit &limit=[LIMIT] status totalResults results website isISP data IPStart IPEnd [IP-ADDRESS-HERE] [YOUR-API-KEY-HERE] status result data city regionShort region countryShort country latititude longitude [YOUR-API-KEY-HERE] [YOUR-WEBSITE-HERE] fieldName1 fieldName2 fieldName3 fieldName4 fieldName5 fieldName6 fieldName7 fieldName8 fieldName9 fieldName10 [YOUR-API-KEY-HERE] [YYYY-MM-DD] [YOUR-API-KEY-HERE] IPv4 IPv6 [IP-ADDRESS-HERE] [YOUR-API-KEY-HERE] status result data countryShort country [YOUR-API-KEY-HERE] [ZIP-CODE-HERE] US status result data city state county countryShort areaCodes latitude longitude [YOUR-API-KEY-HERE] [YOUR-AREA-CODE-HERE] status results data city state county countryShort latitude longitude [WEBSITE-HERE] .svg .png .jpg .jpeg .gif Not Found HTTP 404 ‘Not Found’ [YOUR-API-KEY-HERE] [COMPANY-NAME] Optional Parameters: regionShort &regionShort= countryShort &countryShort= status result data matchRate companyName tradeName website [WEBSITE-HERE] website [WEBSITE-HERE] website Second HTTP 429 ‘Too Many Requests’ CPQ HTTP 429 ‘Too Many Requests’ Revenue Ranges: Employee Ranges: