Skip to Content
API ReferansıHashtagler

Hashtagler

Hashtag grupları, sık kullandığınız hashtag setlerini kaydetmenizi sağlar. Gönderi oluştururken bu grupları içeriğe kolayca ekleyebilirsiniz.

Hashtag değerleri # öneki olmadan gönderilirse API otomatik olarak ekler. Örneğin sosyalkopru → #sosyalkopru.

Hashtag Grubu Oluştur

POST/v1/hashtags

İstek Gövdesi

AlanTipZorunluAçıklama
namestringEvetGrup adı (maks. 255 karakter)
hashtagsstring[]EvetHashtag listesi (en az 1, maks. 30)

Kod Örnekleri

hashtag-grup-olustur.js
const response = await fetch('https://api.sosyalkopru.com/v1/hashtags', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Teknoloji & SaaS',
    // # öneki opsiyonel — API otomatik ekler
    hashtags: ['saas', 'teknoloji', 'yazilim', 'startup', 'girişim', 'sosyalkopru'],
  }),
})
const { data } = await response.json()
console.log('Grup oluşturuldu:', data.id)
console.log('Hashtagler:', data.hashtags.join(' '))

Başarılı Yanıt (201 Created)

{
  "success": true,
  "data": {
    "id": "htg_01HZGK9P3QABC",
    "name": "Teknoloji & SaaS",
    "hashtags": ["#saas", "#teknoloji", "#yazilim", "#startup", "#girişim", "#sosyalkopru"],
    "usageCount": 0,
    "createdAt": "2025-06-10T12:00:00.000Z",
    "updatedAt": "2025-06-10T12:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Hashtag Gruplarını Listele

GET/v1/hashtags

Query Parametreleri

ParametreTipVarsayılanAçıklama
pageinteger1Sayfa numarası
perPageinteger20Sayfa başına kayıt (maks: 100)
searchstring—Grup adı araması
hashtag-listele.js
const response = await fetch('https://api.sosyalkopru.com/v1/hashtags', {
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
})
const { data } = await response.json()
 
data.forEach(g => {
  console.log(`${g.name} (${g.hashtags.length} hashtag, ${g.usageCount}x kullanıldı)`)
  console.log(`  ${g.hashtags.join(' ')}`)
})

Hashtag Grubu Detayı

GET/v1/hashtags/{id}
hashtag-detay.js
const response = await fetch(
  `https://api.sosyalkopru.com/v1/hashtags/${hashtagGroupId}`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data } = await response.json()
console.log(data.name, ':', data.hashtags.join(' '))

Hashtag Grubu Güncelle

PATCH/v1/hashtags/{id}

İstek Gövdesi

AlanTipAçıklama
namestringYeni grup adı
hashtagsstring[]Yeni hashtag listesi (tamamını değiştirir)
hashtag-guncelle.js
const response = await fetch(
  `https://api.sosyalkopru.com/v1/hashtags/${hashtagGroupId}`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      hashtags: ['saas', 'teknoloji', 'yazilim', 'b2b', 'sosyalkopru'],
    }),
  }
)
const { data } = await response.json()
console.log('Güncellendi:', data.hashtags)

Hashtag Grubu Sil

DELETE/v1/hashtags/{id}
await fetch(`https://api.sosyalkopru.com/v1/hashtags/${hashtagGroupId}`, {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
})

Hashtag Grubu ile Gönderi Oluşturma

// 1. Hashtag grubunu al
const htgResponse = await fetch(
  `https://api.sosyalkopru.com/v1/hashtags/${hashtagGroupId}`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data: grup } = await htgResponse.json()
 
// 2. Hashtag'leri gönderi metnine ekle
const hashtagStr = grup.hashtags.join(' ')
const metin = `Yeni içeriğimizi paylaşmaktan mutluluk duyuyoruz! 🚀\n\n${hashtagStr}`
 
// 3. Gönderi oluştur
await fetch('https://api.sosyalkopru.com/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    platforms: ['instagram'],
    content: { text: metin },
    accountIds: ['acc_01HZGK9P3QXYZ'],
    scheduling: { publishAt: '2025-06-20T10:00:00Z' },
  }),
})
Last updated on
ŞablonlarKuyruk