---
updatedAt: 2026-08-11T17:26:24.000Z
agentTools:
  projectIndex: https://buyercaddy-api.readme.io/llms.txt
---

# Get Related Product by custom cohort

Use this to find all related (complementary/competitor/related) products associated with a single product.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "BuyerCaddy Public API",
    "description": "BuyerCaddy has made our benchmarking insights available to our customers and partners through a set of API’s.  These API’s enable MSP’s, resellers and technology consultants to bring the power of BuyerCaddy benchmarking into your own proprietary applications.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.salescaddy.ai/api"
    }
  ],
  "security": [
    {
      "oauth2_client_credentials": []
    },
    {
      "apiKey": []
    }
  ],
  "paths": {
    "/companies/{companyDomain}/products/{productId}/related": {
      "parameters": [
        {
          "name": "companyDomain",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          }
        },
        {
          "name": "productId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          }
        },
        {
          "$ref": "#/components/parameters/SizeParameter"
        }
      ],
      "post": {
        "tags": [
          "Company"
        ],
        "summary": "Get Related Product by custom cohort",
        "operationId": "GetRelatedProductsByCustomCohort",
        "description": "Use this to find all related (complementary/competitor/related) products associated with a single product.",
        "parameters": [
          {
            "name": "cohortCompanyDomain",
            "description": "Cohort company domains",
            "in": "query",
            "required": true,
            "schema": {
              "type": "array",
              "items": {
                "maxItems": 10,
                "type": "string"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RelatedProductDTO"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ClientError"
          },
          "401": {
            "$ref": "#/components/responses/UnauthorizedError"
          },
          "403": {
            "$ref": "#/components/responses/ForbiddenError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "SizeParameter": {
        "name": "size",
        "in": "query",
        "schema": {
          "type": "integer",
          "default": 20,
          "minimum": 0,
          "maximum": 200
        }
      }
    },
    "responses": {
      "ClientError": {
        "description": "Client error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsDTO"
            }
          }
        }
      },
      "UnauthorizedError": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsDTO"
            }
          }
        }
      },
      "ForbiddenError": {
        "description": "Forbidden",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsDTO"
            }
          }
        }
      },
      "InternalError": {
        "description": "Internal error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorsDTO"
            }
          }
        }
      }
    },
    "schemas": {
      "ErrorsDTO": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ErrorDTO"
        },
        "minItems": 1
      },
      "ErrorDTO": {
        "required": [
          "message"
        ],
        "properties": {
          "message": {
            "description": "Description of error",
            "type": "string"
          }
        }
      },
      "ProductDTO": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "logo": {
            "type": "string",
            "format": "uri"
          },
          "category": {
            "type": "string"
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reviewCount": {
            "type": "integer"
          },
          "starRating": {
            "type": "number"
          },
          "avgRating": {
            "type": "number"
          },
          "vendor": {
            "$ref": "#/components/schemas/CompanyDTO"
          },
          "categoryId": {
            "type": "string"
          }
        }
      },
      "RelatedProductDTO": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ProductDTO"
          },
          {
            "type": "object",
            "properties": {
              "percentage": {
                "type": "number",
                "format": "float"
              }
            }
          }
        ]
      },
      "CompanyDTO": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "format": "uri"
          },
          "name": {
            "type": "string",
            "readOnly": true
          },
          "logo": {
            "type": "string",
            "format": "uri",
            "readOnly": true
          }
        }
      }
    },
    "securitySchemes": {
      "oauth2_client_credentials": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://pawannachnani.us.auth0.com/oauth/token?audience=https%3A%2F%2Fbuyercaddy.com%2Fpublic-api",
            "scopes": {
              "public-api:access": "Access to API"
            }
          }
        }
      },
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```