AggKnowledge API

Normalization

Endpointhttps://api.aggknowledgeai.com

V2 APIs to normalize data

Normalize Job Title

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/job-title

Normalizes a job title to standard format (Tier 4)

Normalize Job Title › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize Job Title › Headers

x-api-key

string · required

API key for authentication

Normalize Job Title › Request Body

Job title normalization request

jobTitle

string · required

Job title to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize Job Title › Responses

Job title normalization result

object

Job title normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

POST/v2/{environment}/normalization/job-title

curl --request POST \
  --url https://api.aggknowledgeai.com/v2/:environment/normalization/job-title \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <string>' \
  --data '
{
  "jobTitle": "Sr. Software Engineer",
  "metadata": {
    "key": "string"
  }
}
'

shell

Example Request Body

{
  "jobTitle": "Sr. Software Engineer",
  "metadata": {
    "key": "string"
  }
}

json

Example Responses

{
  "data": {
    "normalizedJobTitle": "senior software engineer"
  },
  "inputParameters": {
    "jobTitle": "Sr. Software Engineer",
    "metadata": {
      "key": "string"
    }
  },
  "isRetryable": true,
  "isSuccess": true,
  "metadata": {
    "key": "string"
  }
}

json

application/json

Normalize LinkedIn URL

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/linkedin-url

Normalizes a LinkedIn URL to standard format (Tier 4)

Normalize LinkedIn URL › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize LinkedIn URL › Headers

x-api-key

string · required

API key for authentication

Normalize LinkedIn URL › Request Body

LinkedIn URL normalization request

linkedinUrl

string · required

LinkedIn URL to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize LinkedIn URL › Responses

LinkedIn URL normalization result

object

LinkedIn URL normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

POST/v2/{environment}/normalization/linkedin-url

curl --request POST \
  --url https://api.aggknowledgeai.com/v2/:environment/normalization/linkedin-url \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <string>' \
  --data '
{
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "metadata": {
    "key": "string"
  }
}
'

shell

Example Request Body

{
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "metadata": {
    "key": "string"
  }
}

json

Example Responses

{
  "data": {
    "normalizedLinkedinUrl": "linkedin.com/in/john-doe"
  },
  "inputParameters": {
    "linkedinUrl": "https://www.linkedin.com/in/john-doe",
    "metadata": {
      "key": "string"
    }
  },
  "isRetryable": true,
  "isSuccess": true,
  "metadata": {
    "key": "string"
  }
}

json

application/json

Extract LinkedIn Username

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/linkedin-username

Extracts a username from a LinkedIn URL (Tier 4)

Extract LinkedIn Username › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Extract LinkedIn Username › Headers

x-api-key

string · required

API key for authentication

Extract LinkedIn Username › Request Body

LinkedIn username extraction request

linkedinUrl

string · required

LinkedIn URL to extract username from

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Extract LinkedIn Username › Responses

LinkedIn username extraction result

object

LinkedIn username extraction request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

POST/v2/{environment}/normalization/linkedin-username

curl --request POST \
  --url https://api.aggknowledgeai.com/v2/:environment/normalization/linkedin-username \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <string>' \
  --data '
{
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "metadata": {
    "key": "string"
  }
}
'

shell

Example Request Body

{
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "metadata": {
    "key": "string"
  }
}

json

Example Responses

{
  "data": {
    "linkedinUsername": "john-doe"
  },
  "inputParameters": {
    "linkedinUrl": "https://www.linkedin.com/in/john-doe",
    "metadata": {
      "key": "string"
    }
  },
  "isRetryable": true,
  "isSuccess": true,
  "metadata": {
    "key": "string"
  }
}

json

application/json

Normalize Website URL

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/website

Normalizes a website URL to top-level domain format (Tier 4)

Normalize Website URL › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize Website URL › Headers

x-api-key

string · required

API key for authentication

Normalize Website URL › Request Body

Website normalization request

website

string · required

Website URL to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize Website URL › Responses

Website normalization result

object

Website normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

POST/v2/{environment}/normalization/website

curl --request POST \
  --url https://api.aggknowledgeai.com/v2/:environment/normalization/website \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <string>' \
  --data '
{
  "metadata": {
    "key": "string"
  },
  "website": "https://www.company.com"
}
'

shell

Example Request Body

{
  "metadata": {
    "key": "string"
  },
  "website": "https://www.company.com"
}

json

Example Responses

{
  "data": {
    "normalizedWebsite": "company.com"
  },
  "inputParameters": {
    "metadata": {
      "key": "string"
    },
    "website": "https://www.company.com"
  },
  "isRetryable": true,
  "isSuccess": true,
  "metadata": {
    "key": "string"
  }
}

json

application/json

Company Rate Limits

Normalize Job Title

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/job-title

Normalizes a job title to standard format (Tier 4)

Normalize Job Title › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize Job Title › Headers

x-api-key

string · required

API key for authentication

Normalize Job Title › Request Body

Job title normalization request

jobTitle

string · required

Job title to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize Job Title › Responses

Job title normalization result

object

Job title normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

Normalize LinkedIn URL

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/linkedin-url

Normalizes a LinkedIn URL to standard format (Tier 4)

Normalize LinkedIn URL › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize LinkedIn URL › Headers

x-api-key

string · required

API key for authentication

Normalize LinkedIn URL › Request Body

LinkedIn URL normalization request

linkedinUrl

string · required

LinkedIn URL to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize LinkedIn URL › Responses

LinkedIn URL normalization result

object

LinkedIn URL normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

Extract LinkedIn Username

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/linkedin-username

Extracts a username from a LinkedIn URL (Tier 4)

Extract LinkedIn Username › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Extract LinkedIn Username › Headers

x-api-key

string · required

API key for authentication

Extract LinkedIn Username › Request Body

LinkedIn username extraction request

linkedinUrl

string · required

LinkedIn URL to extract username from

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Extract LinkedIn Username › Responses

LinkedIn username extraction result

object

LinkedIn username extraction request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request

Normalize Website URL

POST

https://api.aggknowledgeai.com

/v2/{environment}/normalization/website

Normalizes a website URL to top-level domain format (Tier 4)

Normalize Website URL › path Parameters

environment

string · enum · required

Environment (live or test)

Enum values:

live

test

Normalize Website URL › Headers

x-api-key

string · required

API key for authentication

Normalize Website URL › Request Body

Website normalization request

website

string · required

Website URL to normalize

object · maxProps: 10

Optional metadata to associate with the request. Will be returned in the response.

Normalize Website URL › Responses

Website normalization result

object

Website normalization request

isRetryable

boolean

If the request failed, whether the request is retryable with the same input. Always true for successful requests.

isSuccess

boolean

Whether or not the request resulted in a successful enrichment.

object

Caller-supplied metadata associated with the request