---
title: Brändi jälgimine
description: Jälgib brändi mainimisi Brand.dev API abil.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# Brändiseire

Jälgi brändi mainimisi, analüüsi meelestatust ja avasta PR-võimalusi Brand.dev API abil.

## Eeldused

Nõuab, et `BRANDDEV_API_KEY` oleks seatud failis `.env`, `.env.local` või `~/.claude/.env.global`.

```bash
echo "BRANDDEV_API_KEY is ${BRANDDEV_API_KEY:+set}"
```

Kui võtit pole seatud, juhenda kasutajat:
> Sul on vaja Brand.dev API võtit. Hangi see aadressilt https://brand.dev/
> Seejärel lisa oma `.env` faili `BRANDDEV_API_KEY=your_key`.

## API baas

Kõik päringud lähevad aadressile `https://api.brand.dev/v1/` päisega `Authorization: Bearer {BRANDDEV_API_KEY}`.

---

## 1. Brändi otsing

Otsi brändinime mainimisi üle veebi.

### Lõpp-punkt

```
GET https://api.brand.dev/v1/brand/search
```

### Parameetrid

| Parameeter | Tüüp | Kirjeldus |
|-------|------|-------------|
| `query` | string | Otsitav brändinimi või fraas |
| `limit` | int | Tulemuste arv (vaikimisi 20, maksimaalselt 100) |
| `offset` | int | Lehekülgede nihe |
| `sort` | string | `relevance` või `date` |
| `from_date` | string | Alguskuupäev (YYYY-MM-DD) |
| `to_date` | string | Lõppkuupäev (YYYY-MM-DD) |

### Näidis-curl

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/search?query=YourBrand&limit=20&sort=date"
```

### Vastuse parsimine

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/search?query=YourBrand&limit=20" \
  | python3 -c "
import json, sys
data = json.load(sys.stdin)
for m in data.get('results', []):
    print(f\"Source: {m.get('source','')}  |  Title: {m.get('title','')}  |  Sentiment: {m.get('sentiment','n/a')}  |  Date: {m.get('published_at','')}\")
    print(f\"  URL: {m.get('url','')}\")
    print()
"
```

---

## 2. Brändiinfo otsing

Hangi struktureeritud brändiinfo mis tahes ettevõtte või toote kohta.

### Lõpp-punkt

```
GET https://api.brand.dev/v1/brand/info
```

### Parameetrid

| Parameeter | Tüüp | Kirjeldus |
|-------|------|-------------|
| `domain` | string | Ettevõtte domeen (nt `stripe.com`) |
| `name` | string | Brändinimi (domeeni alternatiiv) |

### Näidis-curl

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/info?domain=stripe.com"
```

### Vastuse väljad

- `name`: Ametlik brändinimi
- `domain`: Peamine domeen
- `description`: Brändi kirjeldus
- `industry`: Tegevusala klassifikatsioon
- `founded`: Asutamisaasta
- `headquarters`: Asukoht
- `social_profiles`: Lingid sotsiaalmeediasse
- `logos`: Brändi logode URL-id
- `colors`: Brändi värvipalett
- `employees_range`: Ettevõtte suuruse hinnang

---

## 3. Logo tuvastamine

Tuvasta brändilogosid piltidelt üle veebi.

### Lõpp-punkt

```
GET https://api.brand.dev/v1/logo/search
```

### Parameetrid

| Parameeter | Tüüp | Kirjeldus |
|-------|------|-------------|
| `brand` | string | Otsitav brändinimi |
| `domain` | string | Filtreeri kindla domeeni järgi |
| `limit` | int | Tulemuste arv |

### Näidis-curl

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/logo/search?brand=YourBrand&limit=20"
```

Kasuta logo tuvastamist, et leida:
- Loata logo kasutus
- Partnerite ja sponsorite nähtavus
- Ürituste kajastus ja meediapaigutused
- Võltstoodete kuulutused

---

## 4. Mainimiste jälgimine

Sea üles pidev brändimainimiste jälgimine.

### Monitori loomine

```
POST https://api.brand.dev/v1/monitors
```

### Keha

```json
{
  "name": "My Brand Monitor",
  "keywords": ["YourBrand", "Your Brand", "yourbrand.com"],
  "exclude_keywords": ["unrelated term"],
  "sources": ["news", "blogs", "social", "forums", "reviews"],
  "languages": ["en"],
  "notify_email": "alerts@yourdomain.com"
}
```

### Näidis-curl

```bash
curl -s -X POST -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  -H "Content-Type: application/json" \
  "https://api.brand.dev/v1/monitors" \
  -d '{
    "name": "Brand Alert",
    "keywords": ["YourBrand"],
    "sources": ["news", "blogs", "social"],
    "languages": ["en"]
  }'
```

### Monitoride loetelu

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/monitors"
```

### Monitori tulemuste hankimine

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/monitors/{monitor_id}/mentions?limit=50&sort=date"
```

---

## 5. Meelestatuse analüüs

Analüüsi brändimainimiste meelestatust.

### Lõpp-punkt

```
GET https://api.brand.dev/v1/brand/sentiment
```

### Parameetrid

| Parameeter | Tüüp | Kirjeldus |
|-------|------|-------------|
| `query` | string | Brändinimi |
| `from_date` | string | Alguskuupäev |
| `to_date` | string | Lõppkuupäev |
| `granularity` | string | `day`, `week` või `month` |

### Näidis-curl

```bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/sentiment?query=YourBrand&from_date=2024-01-01&to_date=2024-03-31&granularity=week"
```

### Meelestatuse skoorid

- **Positiivne** (> 0,3): Kiitus, soovitused, positiivsed arvustused
- **Neutraalne** (-0,3 kuni 0,3): Faktilised mainimised, uudiskajastus
- **Negatiivne** (< -0,3): Kaebused, kriitika, negatiivsed arvustused

---

## 6. Konkurentide mainimiste võrdlus

Võrdle brändimainimiste mahtu ja meelestatust konkurentidega.

### Töövoog

1. Otsi mainimisi oma brändi ja iga konkurendi kohta
2. Võrdle mainimiste arvu sama ajavahemiku lõikes
3. Võrdle meelestatuse jaotusi
4. Tuvasta allikad, kus konkurente mainitakse, kuid sind mitte

```bash
# For each brand, get mention counts
for brand in "YourBrand" "Competitor1" "Competitor2"; do
  count=$(curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
    "https://api.brand.dev/v1/brand/search?query=${brand}&limit=1" \
    | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))")
  echo "${brand}: ${count} mentions"
done
```

---

## Töövoog: täielik brändiaudit

Kui palutakse koostada põhjalik brändiseire raport:

### 1. samm: brändiinfo

Tõmba konteksti jaoks struktureeritud brändiandmed.

### 2. samm: mainimiste maht

Otsi brändimainimisi viimase 30/90 päeva jooksul. Loe kokku mainimiste koguarv ja jaota allikatüübi järgi.

### 3. samm: meelestatuse analüüs

Hangi meelestatuse trendid. Märgista kõik negatiivsed hüpped ja uuri algpõhjuseid.

### 4. samm: PR-võimalused

Mainimisandmetest tuvasta:
- **Kõrge autoriteediga saidid**, mis mainivad konkurente, aga mitte sind
- **Ajakirjanikud**, kes kajastavad sinu tegevusala
- **Trendikad teemad**, kus sinu bränd saaks kaasa rääkida
- **Vastamata küsimused** sinu brändi kohta foorumites

### 5. samm: logo/visuaalne kohalolu

Otsi logode esinemisi. Märgista loata kasutus.

### 6. samm: raport

Esita leiud kujul:

```
## Brand Monitoring Report: {Brand}

### Overview
- Total mentions (last 30 days): X
- Sentiment breakdown: X% positive, X% neutral, X% negative
- Top sources: ...

### Sentiment Trend
[Weekly trend data]

### Top Positive Mentions
1. [Source] - [Title] - [URL]
2. ...

### Negative Mentions Requiring Attention
1. [Source] - [Title] - [URL] - [Issue summary]
2. ...

### PR Opportunities
1. [Publication] covers [topic] - pitch angle: ...
2. [Journalist] recently wrote about [topic] - pitch angle: ...

### Competitor Comparison
| Metric | Your Brand | Competitor A | Competitor B |
|--------|-----------|-------------|-------------|
| Mentions | ... | ... | ... |
| Positive % | ... | ... | ... |
| Top Source | ... | ... | ... |

### Action Items
- [ ] Respond to [negative mention]
- [ ] Pitch [publication] about [topic]
- [ ] Update brand listing on [platform]
```

---

## Vigade käsitlemine

| Olek | Tähendus |
|--------|---------|
| 401 | Vigane või aegunud API võti |
| 403 | Ebapiisavad õigused selle lõpp-punkti jaoks |
| 404 | Ressurssi ei leitud (kontrolli monitori ID-d) |
| 429 | Päringulimiit ületatud – oota ja proovi uuesti |
| 500 | Serveri viga – proovi mõne sekundi pärast uuesti |

## Nipid

- Kasuta märksõnadena täpset brändinime + levinud kirjavigu
- Välista oma domeen, et vältida enesemainimisi
- Sea monitorid üles ka konkurentide brändidele
- Kontrolli mainimisi vähemalt kord nädalas; igapäevaselt toodete turuletuleku või kriiside ajal
- Ekspordi negatiivsed mainimised arvutustabelisse klienditoe järeltegevuse jaoks