overview      pricing      documentation      login      SIGNUP

API documentation

HTTPS/SSL

Our Company API is only available over secure HTTPS connection and all requests must include https:// to make them secure.

Versioning

OrgInfo handles inevitable changes in API with URI versioning, with the API version embedded in the URL path. Our APIs are prefixed with `/data/`.

The current version of our API is v1.

A new version of the API will be released when changes are backwards incompatible. We strongly recommend that you test the APIs well with the latest version when you upgrade.

Authentication

Your API key is used to authenticate you as a valid user and must be provided for all API calls using the key URL parameter. To get a valid API key, please sign up as a OrgInfo user and your key is displayed on your dashboard.

Query parameters

Apart from the API key, a single, valid IP address must be provided as an input parameter. IP address can be in IPv4 or IPv6 format

https://api.orginfo.io/data/v1/org/company?key=$KEY&ip=$IP_ADDRESS

Response

A JSON response is provided, with the following fields:

Usage count

OrgInfo employs a learning system to build its database and hence may not be able to provide responses for some of your API calls. Only APIs that return a response will be counted towards your free/monthly quota.

Rate/quota limit

If your API usage exceeds the free quota or monthly limits associated with your paid subscription, the API will return 429 HTTP status code.

Caching/storing responses

As per our Terms of Service, you must not store data provided via our API response in any permanent storage of your application. Further, any caching/local storage that is employed must be limited to 24 hours.

Sample query & response

https://api.orginfo.io/data/v1/org/company?key=XXXXXXXXXX&ip=199.66.9.12

Response:

{
      type: “business”,
      name: "Tesla Inc.",
      website: "https://www.tesla.com",
      industry: “Automotive",
      linkedinURL:  “https://www.linkedin.com/company/tesla-motors",
      employeeCount: “10,001+ employees",
      headquarterAddress: "3500 Deer Creek Road, Palo Alto, CA 94304",
      headquarterCity: “Palo Alto",
      headquarterRegion: “California",
      headquarterCountry: “United States”
}