Get company infrastructure assets

Rankiteo API (0.0.1-beta)

The Rankiteo API

Download OpenAPI description

openapi.json

openapi.yaml

Overview

URL https://gitbook.com/support

API Support support@rankiteo.com

Servers

Mock server

https://apidocs.rankiteo.com/_mock/openapi/

production

https://api.rankiteo.com/

General

Operations

Monitor

Operations

Add manual subsidiary

Request

Add manual subsidiary under parent subsidiary

Bodyapplication/jsonrequired

namestringrequired

Name of the subsidiary to be added

Example: "scoring"

websitestringrequired

Website of the subsidiary

Example: "https://appler.co"

employeesstringrequired

Employee number company have

Example: 100

followersstringrequired

Follower number company have

Example: 100

industrystringrequired

Industry type of the parent company. Please refers https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2

Example: "Cyber security"

sub_industrystringrequired

Industry type of the subsidiary company. Please refers https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2

Example: "Cyber"

linkedin_idstring

linkedin Id of the company

Example: "Cyber"

parent_company_namestring

Name of the parent company

Example: "Rankiteo"

parent_linkedin_idstring

Linkedin Id of the parent company

Example: "rankiteo"

curl -i -X POST \
  https://apidocs.rankiteo.com/_mock/openapi/monitor-add-subsidiary \
  -H 'Content-Type: application/json' \
  -H 'apikey: YOUR_API_KEY_HERE' \
  -d '{
    "name": "scoring",
    "website": "https://appler.co",
    "employees": 100,
    "followers": 100,
    "industry": "Cyber security",
    "sub_industry": "Cyber",
    "linkedin_id": "Cyber",
    "parent_company_name": "Rankiteo",
    "parent_linkedin_id": "rankiteo"
  }'

Responses

Successful response for add request

Bodyapplication/json

messagestring

Example: "Subsidiary added successfully"

Response

application/json

{
  "message": "Subsidiary added successfully"
}

Delete manual subsidiary

Request

Delete manual subsidiary

Query

subsidiary_idstringrequired

subsidiary id of company

Example: subsidiary_id=YOU_2660260

curl -i -X DELETE \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-delete-subsidiary?subsidiary_id=YOU_2660260' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response for delete request

Bodyapplication/json

messagestring

Example: "Subsidiary deleted successfully"

Response

application/json

{
  "message": "Subsidiary deleted successfully"
}

Get data loss prediction

Request

Get data loss prediction for 6 months or 12 months for a specific company

Query

periodnumber

Period value is a timeframe. It can be 6 or 12. By default its value is 6

Example: period=6

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-get-data-loss-prediction?period=6' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Data loss prediction response for three incident types - Cyber Attack, Human/System Error and Physical Attack

Bodyapplication/json

linkedin_idstring

LinkedIn identifier for the company

Example: "google"

periodinteger

Timeframe of prediction

Example: 6

dataArray of objects

messagestring

Example: "No predictions available"

Response

application/json

{
  "linkedin_id": "google",
  "period": 6,
  "data": [
    { … },
    { … },
    { … }
  ]
}

Get incident prediction

Request

Get incident prediction for 6 months or 12 months for a specific company

Query

periodnumber

Period value is a timeframe. It can be 6 or 12. By default its value is 6

Example: period=6

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-get-incident-prediction?period=6' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Incident prediction response for three incident types - Cyber Attack, Human/System Error and Physical Attack

Bodyapplication/json

linkedin_idstring

Example: "google"

periodinteger

Example: 6

dataArray of objects

messagestring

Example: "No predictions available"

Response

application/json

{
  "linkedin_id": "google",
  "period": 6,
  "data": [
    { … },
    { … },
    { … }
  ]
}

Get subdomain findings

Request

Subdomain findings list

Query

subdomainstringrequired

subdomain of company

Example: subdomain=google.com

risk_vector_typestringrequired

risk vector type

Example: risk_vector_type=DKIM

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-get-subdomain-findings?page=1&risk_vector_type=DKIM&subdomain=google.com' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subdomain findings and pagination.

Bodyapplication/json

dataobject

paginationobject

messageobject

Example: {"data":{"subdomain_name":"rankiteo.com","message":"No DKIM findings for this domain"}}

Response

application/json

{
  "data": {
    "domain_name": "rankiteo.com",
    "subdomain": [ … ]
  },
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 5,
    "total_items": 47
  }
}

Get tail risk estimation

Request

Get tail risk estimation for 6 months or 12 months for a specific company

Query

periodnumber

Period value is a timeframe. It can be 6 or 12. By default its value is 6

Example: period=6

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-get-tail-risk-estimation?period=6' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Tail risk estimation response for three incident types - Cyber Attack, Human/System Error and Physical Attack

Bodyapplication/json

linkedin_idstring

LinkedIn identifier for the company

Example: "google"

periodinteger

Timeframe of prediction

Example: 6

dataArray of objects

messagestring

Example: "No estimations available"

Response

application/json

{
  "linkedin_id": "google",
  "period": 6,
  "data": [
    { … },
    { … },
    { … }
  ]
}

Get all subdomain findings

Request

Subdomain findings list

Query

subdomainstringrequired

subdomain of company

Example: subdomain=google.com

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getall-subdomain-findings?page=1&subdomain=google.com' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subdomain findings and pagination.

Bodyapplication/json

dataobject

paginationobject

messageobject

Example: {"data":{"subdomain_name":"rankiteo.com","message":"No findings for this domain"}}

Response

application/json

{
  "data": {
    "domain_name": "rankiteo.com",
    "subdomain": [ … ]
  },
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 5,
    "total_items": 47
  }
}

Get all vulnerability detection for a specific company

Request

Company vulnerability detection

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getall-vulnerability-detection?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing LinkedIn ID and vulnerability detection data

Bodyapplication/json

linkedin_idstring

Example: "apple"

dataArray of objects

paginationobject

messagestring

Example: "No vulnerabilty detection found for this Linkedin Id"

Response

application/json

{
  "linkedin_id": "apple",
  "data": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 1,
    "total_pages": 1,
    "total_items": 1
  }
}

Get company history

Request

Company history information

curl -i -X GET \
  https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompany-history \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing history

Bodyapplication/json

dataArray of objects

messagestring

Example: "No history available"

Response

application/json

{
  "linkedin_id": "apple",
  "incidents": [
    { … }
  ]
}

Get company applications assets

Request

Company asset informations

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanyapplicationsassets?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing company information, applications, and pagination data

Bodyapplication/json

linkedin_idstring

Unique identifier for the company on LinkedIn

Example: "google"

company_namestring

The official name of the company

Example: "Google"

websitestring

Official website URL of the company

Example: "https://goo.gle/3DLEokh"

industrystring

Industry category of the company

Example: "Software Development"

descriptionstring

A brief description of the company and its mission

Example: "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone"

number_of_applicationsinteger

Total number of applications or technologies identified as being used by the company

Example: 2241

applicationsArray of objects

List of applications and technologies associated with the company

paginationobject

Information about the pagination of results

messagestring

Example: "No data available"

Response

application/json

{
  "linkedin_id": "google",
  "company_name": "Google",
  "website": "https://goo.gle/3DLEokh",
  "industry": "Software Development",
  "description": "A problem isn't truly solved until it's solved for all",
  "number_of_applications": 2241,
  "applications": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 10,
    "total_items": 100
  }
}

Get company details

Request

Responses

Company information response

Bodyapplication/json

linkedin_idstring

LinkedIn identifier for the company

Example: "google"

company_namestring

Name of the company

Example: "Google"

websitestring(uri)

Website URL of the company

Example: "https://goo.gle/3DLEokh"

industrystring

Industry the company operates in

Example: "Software Development"

descriptionstring

Company description

Example: "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe"

company_idstring

Unique company identifier

Example: "GOO_2660260"

crunchbase_idstring(uri)

URL to Crunchbase profile for the company

Example: "https://www.crunchbase.com/organization/google/funding_rounds/funding_rounds_list"

employees_numberstring

Total number of employees in the company

Example: "300967 employees"

followers_numberinteger

Total number of LinkedIn followers

Example: 34225598

scorenumber(float)

Company score based on internal criteria

Example: 410.42

naics_codestring

NAICS code associated with the company's industry

Example: 511

searched_byinteger

Number of searches or views related to this company

Example: 8

subsidiaries_listArray of strings

List of subsidiaries or associated entities under the company

Example: ["Adometry (acquired by Google)","Android","Google Cloud","YouTube"]

ip_addressesinteger

Number of IP addresses associated with the company

Example: 1600

Response

application/json

{
  "linkedin_id": "google",
  "company_name": "Google",
  "website": "https://goo.gle/3DLEokh",
  "industry": "Software Development",
  "description": "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe",
  "company_id": "GOO_2660260",
  "crunchbase_id": "https://www.crunchbase.com/organization/google/funding_rounds/funding_rounds_list",
  "employees_number": "300967 employees",
  "followers_number": 34225598,
  "score": 410.42,
  "naics_code": 511,
  "searched_by": 8,
  "subsidiaries_list": [
    "Adometry (acquired by Google)",
    "Android",
    "Google Cloud",
    "YouTube"
  ],
  "ip_addresses": 1600
}

Get company infrastructure assets

Request

Company infrastructure assets

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanyinfrastructureassets?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing company information, network endpoints, and pagination data

Bodyapplication/json

linkedin_idstring

Unique identifier for the company on LinkedIn

Example: "google"

company_namestring

The official name of the company

Example: "Google"

websitestring

Official website URL of the company

Example: "https://goo.gle/3DLEokh"

industrystring

Industry category of the company

Example: "Software Development"

descriptionstring

A brief description of the company and its mission

Example: "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone"

number_of_infrastructure_endpointinteger

Total number of network endpoints associated with the company's infrastructure

Example: 1600

network_endpointsArray of objects

List of network endpoints used by the company

paginationobject

Information about the pagination of results

messagestring

Example: "No data available"

Response

application/json

{
  "linkedin_id": "google",
  "company_name": "Google",
  "website": "https://goo.gle/3DLEokh",
  "industry": "Software Development",
  "description": "A problem isn't truly solved until it's solved for all",
  "number_of_infrastructure_endpoint": 2241,
  "network_endpoints": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 10,
    "total_items": 100
  }
}

Get company SBOM data

Request

Company SBOM data includes technology information

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanysbom?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subdomains and technology information or a message

Bodyapplication/json

dataArray of objects

paginationobject

messagestring

Example: "No SBOM vulnerability found"

Response

application/json

{
  "data": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 10,
    "total_items": 100
  },
  "message": "Data fetched successfully"
}

Get company SBOM data with CVE

Request

Company SBOM data includes technology information with cve

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanysbomcve?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subdomains and technology information or a message

Bodyapplication/json

dataArray of objects

paginationobject

messagestring

Example: "No SBOM vulnerability found"

Response

application/json

{
  "data": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 10,
    "total_items": 100
  },
  "message": "Data fetched successfully"
}

Get company SBOM data by domain

Request

Company SBOM data includes technology information

Query

domainstringrequired

domain of company

Example: domain=google.com

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanysbomdomain?domain=google.com&page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subdomains and technology information or a message

Bodyapplication/json

dataobject

paginationobject

messagestring

Example: "No SBOM vulnerability found"

Response

application/json

{
  "data": {
    "domain_name": "google.com",
    "subdomain": [ … ]
  },
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_pages": 3,
    "total_items": 23
  }
}

Get company global scoring

Request

Company scoring without subsidiaries

curl -i -X GET \
  https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanyscores \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response with LinkedIn company profile information

Bodyapplication/json

linkedin_idstring

LinkedIn ID of the company

Example: "google"

company_namestring

Name of the company

Example: "Google"

websitestring(uri)

Company's website URL

Example: "https://goo.gle/3DLEokh"

industrystring

Industry type

Example: "Software Development"

descriptionstring

Company description

Example: "A problem isn't truly solved until it's solved for all"

subsidiaries_numberinteger

Number of subsidiaries

Example: 46

scoreobject

messagestring

Example: "No data available"

Response

application/json

{
  "linkedin_id": "google",
  "company_name": "Google",
  "website": "https://goo.gle/3DLEokh",
  "industry": "Software Development",
  "description": "A problem isn't truly solved until it's solved for all",
  "subsidiaries_number": 0,
  "score": {
    "spf": { … },
    "dkim": { … },
    "certificate_conf": { … },
    "certificate_info": { … },
    "open_ports": { … },
    "web_headers": { … },
    "dmarc": { … },
    "it_standardization": { … },
    "digitalization": { … },
    "certificate_cve": { … },
    "vulnerabilities": { … },
    "sbom": { … }
  }
}

Get company statistics data

Request

Company stats with all subsidiaries

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanystats?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful Response

Bodyapplication/json

parent_linkedin_idstring

Example: "google"

subsidiaries_statsArray of objects

paginationobject

messagestring

Example: "No data available"

Response

application/json

{
  "parent_linkedin_id": "apple",
  "subsidiaries_stats": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 1,
    "total_pages": 1,
    "total_items": 1
  }
}

Get company scoring including subsidiaries

Request

Company scoring with all subsidiaries

Query

pageinteger

Page number

Example: page=1

curl -i -X GET \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanysubscores?page=1' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing LinkedIn ID and subsidiaries' scores

Bodyapplication/json

linkedin_idstring

Example: "google"

subsidiaries_scoresArray of objects

paginationobject

messagestring

Example: "No data available"

Response

application/json

{
  "linkedin_id": "apple",
  "subsidiaries_scores": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 1,
    "total_pages": 1,
    "total_items": 1
  }
}

Get company subsidiaries

Request

Company subsidiaries information

curl -i -X GET \
  https://apidocs.rankiteo.com/_mock/openapi/monitor-getcompanysubsidiaries \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response with company profile information

Bodyapplication/jsonArray [

linkedin_idstring

LinkedIn ID of the company

Example: "google"

company_namestring

Name of the company

Example: "Google"

websitestring(uri)

Company's website URL

Example: "https://goo.gle/3DLEokh"

industrystring

Industry type of the company

Example: "Software Development"

descriptionstring

Company description

Example: "A problem isn't truly solved until it's solved for all"

company_idstring

Unique company identifier

Example: "GOO_2660260"

crunchbase_idstring(uri)

URL to the company's Crunchbase profile

Example: "https://www.crunchbase.com/organization/google/funding_rounds/funding_rounds_list"

employees_numberstring

Approximate number of employees

Example: "300967 employees"

followers_numberinteger

Number of LinkedIn followers

Example: 34225598

scorenumber(float)

Overall company score

Example: 410.42

naics_codestring

NAICS code for the company's industry

Example: 511

serched_byinteger

Number of times the company was searched

Example: 8

ip_addressesinteger

Approximate number of associated IP addresses

Example: 1600

]

Response

application/json

[
  {
    "linkedin_id": "google",
    "company_name": "Google",
    "website": "https://goo.gle/3DLEokh",
    "industry": "Software Development",
    "description": "A problem isn't truly solved until it's solved for all",
    "company_id": "GOO_2660260",
    "crunchbase_id": "https://www.crunchbase.com/organization/google/funding_rounds/funding_rounds_list",
    "employees_number": "300967 employees",
    "followers_number": 34225598,
    "score": 410.42,
    "naics_code": 511,
    "serched_by": 8,
    "ip_addresses": 1600
  }
]

Get subsidiaries list

Request

Company subsidiaries list

curl -i -X GET \
  https://apidocs.rankiteo.com/_mock/openapi/monitor-listsubsidiaries \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response containing subsidiary information

Bodyapplication/json

linkedin_idstring

Example: "rankiteo"

subsidiaries_listArray of objects

paginationobject

messagestring

Example: "No data available"

Response

application/json

{
  "linkedin_id": "rankiteo",
  "subsidiaries_list": [
    { … }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 5,
    "total_pages": 1,
    "total_items": 5
  }
}

Rescan subdomain by vector id

Request

Rescan subdomain by vector id

Query

subdomainstringrequired

subdomain of company

Example: subdomain=google.com

risk_vector_idstringrequired

risk vector id

Example: risk_vector_id=674f9bfab40bb949f7649811

curl -i -X PUT \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-rescan-subdomain-by-vectorid?risk_vector_id=674f9bfab40bb949f7649811&subdomain=google.com' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response for scan request

Bodyapplication/json

messagestring

Example: "Scan request for subdomain rankiteo.com with vector type DKIM has been successfully received and will be processed soon"

Response

application/json

{
  "message": "Scan request for subdomain rankiteo.com with vector type DKIM has been successfully received and will be processed soon"
}

Rescan subdomain by vector type

Request

Rescan subdomain by vector type

Query

subdomainstringrequired

subdomain of company

Example: subdomain=google.com

risk_vector_typestringrequired

risk vector type

Example: risk_vector_type=DKIM

curl -i -X PUT \
  'https://apidocs.rankiteo.com/_mock/openapi/monitor-rescan-subdomain-by-vectortype?risk_vector_type=DKIM&subdomain=google.com' \
  -H 'apikey: YOUR_API_KEY_HERE'

Responses

Successful response for scan request

Bodyapplication/json

messagestring

Example: "Scan request for subdomain rankiteo.com with vector type DKIM has been successfully received and will be processed soon"

Response

application/json

{
  "message": "Scan request for subdomain rankiteo.com with vector type DKIM has been successfully received and will be processed soon"
}

Underwriter

Operations

Rankiteo API (0.0.1-beta)

General

Monitor

Add manual subsidiary

Request

Responses

Was this helpful?

Delete manual subsidiary

Request

Responses

Was this helpful?

Get data loss prediction

Request

Responses

Was this helpful?

Get incident prediction

Request

Responses

Was this helpful?

Get subdomain findings

Request

Responses

Was this helpful?

Get tail risk estimation

Request

Responses

Was this helpful?

Get all subdomain findings

Request

Responses

Was this helpful?

Get all vulnerability detection for a specific company

Request

Responses

Was this helpful?

Get company history

Request

Responses

Was this helpful?

Get company applications assets

Request

Responses

Was this helpful?

Get company details

Request

Responses

Was this helpful?

Get company infrastructure assets

Request

Responses

Was this helpful?

Get company SBOM data

Request

Responses

Was this helpful?

Get company SBOM data with CVE

Request

Responses

Was this helpful?

Get company SBOM data by domain

Request

Responses

Was this helpful?

Get company global scoring

Request

Responses

Was this helpful?

Get company statistics data

Request

Responses

Was this helpful?

Get company scoring including subsidiaries

Request

Responses

Was this helpful?

Get company subsidiaries

Request

Responses

Was this helpful?

Get subsidiaries list