Skip to main content
Remove a user-added competitor. Only competitors with source: "user_added" can be deleted. Auto-discovered competitors cannot be removed.

​
Path Parameters

ParameterTypeRequiredDescription
competitor_idstringYesCompetitor UUID

​
Example Request

curl -X DELETE https://searchcompany-main.up.railway.app/api/explore/competitor/550e8400-e29b-41d4-a716-446655440002 \
  -H "Authorization: Bearer $TOKEN"

​
Example Response (Success)

{
  "status": "success",
  "message": "Removed Lululemon"
}

​
Example Response (Cannot Remove Auto-Discovered)

{
  "status": "error",
  "error": "Cannot remove auto-discovered competitors"
}

​
Example Response (Not Found)

{
  "status": "error",
  "error": "Competitor not found"
}

​
Response Fields

FieldTypeDescription
statusstring"success" or "error"
messagestringSuccess message (on success)
errorstringError message (on failure)