Competitors

List project competitors

Changed on

List all competitors monitored within a project. Includes the project's own domain (marked with isOwn: true) and all added competitor domains.

get/v1/projects/{projectId}/competitors

Request

  • Base URL: https://api.competlab.com
  • URL: https://api.competlab.com/v1/projects/{projectId}/competitors
  • Auth: API key in header CL-API-Key

Path parameters

projectIdstring required
Example:507f1f77bcf86cd799439011

Project ID

Response

Example response

{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "domain": "competitor.com",
      "preparationStatus": "complete",
      "createdAt": "2026-01-15T12:00:00.000Z"
    }
  ]
}

Changes

  • 4f4cef27c196Revision changes
    • info

      for the path request parameter projectId, the type was generalized from no type to string

  • 6a49febf6774Revision changes
    • warning

      added the new api_key_expired enum value to the / response property for the response status

    • warning

      added the new api_key_invalid enum value to the / response property for the response status

    • warning

      added the new api_key_missing enum value to the / response property for the response status

    • warning

      added the new api_key_revoked enum value to the / response property for the response status

    • warning

      added the new insufficient_scope enum value to the / response property for the response status