Demographics Company API

Lookup company by domain

get

Our Company API lets you lookup a company profile via a domain name. It returns the predictive customer fit of the company (aka. demographics score), the top signals behind this score (ie. why is this company a good fit or not), and some light demographics information (eg. number of employees, industry, etc.).

Authorizations

Query parameters

domainstringRequired

The domain name of the company you would like to retrieve

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

404

The server cannot find the requested resource.

application/json

429

Client error

application/json

500

Server error

application/json

get

HTTPcURLJavaScriptPython

GET /v1/companies HTTP/1.1
Host: api.madkudu.com
Authorization: Basic YOUR_SECRET_TOKEN
Accept: */*

{
  "object_type": "company",
  "domain": "madkudu.com",
  "properties": {
    "name": "MadKudu",
    "domain": "madkudu.com",
    "location": {
      "state": "California",
      "state_code": "CA",
      "country": "United States",
      "country_code": "US",
      "tags": [
        "english_speaking",
        "high_gdp_per_capita"
      ]
    },
    "number_of_employees": 10,
    "industry": "Internet Software & Services",
    "customer_fit": {
      "segment": "good",
      "score": 37,
      "top_signals": [
        {
          "name": "employee count",
          "value": 10,
          "type": "negative"
        },
        {
          "name": "based in a country where gdp per capita",
          "value": "high",
          "type": "positive"
        },
        {
          "name": "capital raised",
          "value": 1370000,
          "type": "positive"
        }
      ],
      "top_signals_formated": "↑ based in a country where gdp per capita is high\n↑ capital raised is 1,370,000\n↑ belongs to industry where revenue per employee is high\n↑ number of tech found on website is 10\n✖ employee count is 10\n✖ web traffic volume is low"
    },
    "predicted_value": 327.4
  }
}

Lookup company with enriched payload

post

This API endpoint lets you provide your own enriched company data.

Authorizations

Body

Company lookup with payload request

domainstringRequired

Company domain

companyall ofRequired

Clearbit company payload

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

422

Client error

application/json

429

Client error

application/json

500

Server error

application/json

post

HTTPcURLJavaScriptPython

POST /v1/companies HTTP/1.1
Host: api.madkudu.com
Authorization: Basic YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 424

{
  "domain": "madkudu.com",
  "company": {
    "id": "a996c075-7bf1-4324-ad26-e59e97ba4fd2",
    "name": "MadKudu",
    "legalName": "MadKudu, Inc.",
    "domain": "madkudu.com",
    "category": {
      "sector": "Information Technology",
      "industryGroup": "Software & Services",
      "industry": "Internet Software & Services",
      "subIndustry": "Internet Software & Services"
    },
    "metrics": {
      "employees": 10,
      "employeesRange": "1-10",
      "raised": 1370001,
      "estimatedAnnualRevenue": "$1M-$10M"
    }
  }
}

{
  "object_type": "company",
  "domain": "madkudu.com",
  "properties": {
    "name": "MadKudu",
    "domain": "madkudu.com",
    "location": {
      "state": "California",
      "state_code": "CA",
      "country": "United States",
      "country_code": "US",
      "tags": [
        "english_speaking",
        "high_gdp_per_capita"
      ]
    },
    "number_of_employees": 10,
    "industry": "Internet Software & Services",
    "customer_fit": {
      "segment": "good",
      "score": 37,
      "top_signals": [
        {
          "name": "employee count",
          "value": 10,
          "type": "negative"
        },
        {
          "name": "based in a country where gdp per capita",
          "value": "high",
          "type": "positive"
        },
        {
          "name": "capital raised",
          "value": 1370000,
          "type": "positive"
        }
      ],
      "top_signals_formated": "↑ based in a country where gdp per capita is high\n↑ capital raised is 1,370,000\n↑ belongs to industry where revenue per employee is high\n↑ number of tech found on website is 10\n✖ employee count is 10\n✖ web traffic volume is low"
    },
    "predicted_value": 327.4
  }
}