SEsecurityscorecard
scores

Search companies in bulk

Changed on

Search companies in bulk

post/companies/bulk-searches

Request

  • Base URL
    https://api.securityscorecard.io
  • URL
    https://api.securityscorecard.io/companies/bulk-searches
  • Auth
    API key in header Authorization

Request body

searchesstring[] required

search text array

maxSearchesinteger

number of searches to perform

Example request

{
  "searches": [
    "Microsoft"
  ]
}

Response

Get all the domains for the parent domain

Example response

{
  "scorecards": [
    {
      "id": "aea7dae2-370f-4279-a458-4c7cb9661778",
      "domain": "example.com",
      "name": "Example Ltd.",
      "searches": {
        "original_query": "example ltd",
        "match_query": "example",
        "result": "example.com",
        "source": "database",
        "reason": "third party restricted match",
        "category": "domain",
        "attempt": 5,
        "confidence": 5
      }
    }
  ],
  "not_found": [
    {
      "order": 1,
      "attempts": [
        {
          "query": "example ltd",
          "reason": "global exact search no match",
          "category": "name",
          "attempt": 2
        }
      ]
    }
  ]
}

Changes

  • b465b4846039Revision changes
    • breaking

      the response property // became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      the / response's property type changed from string to no type for status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      the response property /// became required for the status

    • info

      the // response's property pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ was added for the status