Public API.

Onaylı bayrakları listele, filtrele ve sırala.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/flags?sort=net&category=CHARACTER&limit=10"

{
  "count": 10,
  "sort": "net",
  "limit": 10,
  "offset": 0,
  "data": [
    {
      "id": "cln...",
      "slug": "yaslilara-saygi-gosteriyor",
      "category": "CHARACTER",
      "region": null,
      "text": {
        "tr": "Yaslilara saygi gosteriyor",
        "en": "Respects the elderly",
        "de": "Respektiert altere Menschen",
        "es": "Respeta a los mayores"
      },
      "votes": {
        "red": 4200,
        "green": 198400,
        "total": 202600,
        "net": -194200
      },
      "dominant": "green",
      "createdAt": "2026-05-25T..."
    }
  ]
}

Tek bayrak, açıklama + bağlamlar dahil.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/flag/yaslilara-saygi-gosteriyor"

{
  "id": "cln...",
  "slug": "yaslilara-saygi-gosteriyor",
  "category": "CHARACTER",
  "region": null,
  "contexts": ["ROMANTIC", "FRIEND", "FAMILY"],
  "text": { "tr": "...", "en": "...", "de": "...", "es": "..." },
  "description": { "tr": null, "en": null, "de": null, "es": null },
  "votes": { "red": 4200, "green": 198400, "total": 202600, "net": -194200 },
  "dominant": "green",
  "createdAt": "2026-05-25T..."
}

Bayrağın günlük oy snapshot zaman serisi (kırmızı/yeşil/net zaman içinde). Trend grafiği çizmek için.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/flag/sigara-iciyor/trend?days=14"

{
  "slug": "sigara-iciyor",
  "days": 14,
  "count": 14,
  "current": { "red": 18000, "green": 2000, "total": 20000, "net": 16000 },
  "snapshots": [
    {
      "at": "2026-05-15T00:00:00.000Z",
      "red": 17200,
      "green": 1850,
      "total": 19050,
      "net": 15350
    },
    ...
  ]
}

Tüm kategoriler + onaylı bayrak sayıları.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/categories"

{
  "count": 8,
  "data": [
    { "slug": "character", "enum": "CHARACTER", "count": 73 },
    { "slug": "behavioral", "enum": "BEHAVIORAL", "count": 45 },
    ...
  ]
}

Tüm bölgeler + onaylı bayrak sayıları. region NULL = 'world'.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/regions"

{
  "count": 12,
  "data": [
    { "code": null, "label": "world", "count": 240 },
    { "code": "TR", "label": "TR", "count": 32 },
    { "code": "DE", "label": "DE", "count": 12 },
    ...
  ]
}

Global istatistik: flag/user/vote sayısı, 24s/7g/30g aktivite, top 5 kategori.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/stats"

{
  "flags": {
    "total": 294,
    "redDominant": 115,
    "greenDominant": 179,
    "mixed": 0,
    "addedLast24h": 5
  },
  "users": { "total": 142 },
  "votes": {
    "total": 12450,
    "last24h": 240,
    "last7d": 1820,
    "last30d": 8200
  },
  "topCategories": [
    { "slug": "character", "enum": "CHARACTER", "count": 73 },
    ...
  ],
  "generatedAt": "2026-05-28T..."
}

Full-text arama (Postgres tsvector, 4 dil destekli). 2+ karakter, prefix-match.

curl -H "Authorization: Bearer grf_xxx..." \
  "https://greenredflagger.com/api/public/search?q=sigara&limit=5"

{
  "count": 3,
  "q": "sigara",
  "data": [
    {
      "id": "cln...",
      "slug": "sigara-iciyor",
      "category": "BEHAVIORAL",
      "region": null,
      "text": { "tr": "Sigara iciyor", "en": "Smokes", ... },
      "votes": { "red": 18000, "green": 2000, "total": 20000, "net": 16000 },
      "dominant": "red",
      "rank": 0.0759
    }
  ]
}