SNSTrackerSNSTracker

API Referansı

Genel Bakış

SNSTracker API, izleme beslemelerini ve kanallarını programatik olarak yönetmenizi sağlar. Beslemeler (videolar, gönderiler vb.) ve kanallar (hesaplar, profiller) oluşturabilir, en güncel verileri almak için yenileyebilir ve webhook’lar aracılığıyla gerçek zamanlı bildirimler alabilirsiniz.

Kimlik Doğrulama

Tüm API istekleri bir API anahtarıyla kimlik doğrulaması gerektirir. API anahtarınızı X-API-Key başlığında gönderin.

API anahtarınızı nasıl alırsınız:

  1. SNSTracker’a giriş yapın
  2. Ayarlar → API Anahtarları bölümüne gidin
  3. Yeni bir API anahtarı oluşturun veya mevcut olanı kullanın
  4. API anahtarını kopyalayın (oluşturulduğunda yalnızca bir kez görürsünüz)

API Uç Noktaları

1. Besleme Oluşturma

Besleme URL’leri (videolar, gönderiler vb.) göndererek izleme beslemeleri oluşturun.

POST /api/v1/feeds

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "urls": [
    "https://www.tiktok.com/@user/video/1234567890",
    "https://www.instagram.com/p/ABC123/"
  ],
  "collectionId": "coll_abc123xyz"
}

Parametreler:

  • urls (gerekli): İzlenecek besleme URL’lerinin dizisi. İstek başına en fazla 200 URL.
  • collectionId (isteğe bağlı): Beslemelerin ekleneceği koleksiyon kimliği. Sağlanmazsa ekibinizin varsayılan koleksiyonu kullanılır.

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@user/video/1234567890",
        "platform": "tiktok",
        "feedId": "feed_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/p/ABC123/",
        "platform": "instagram",
        "feedId": "feed_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Beslemeler başarıyla oluşturuldu. Veriler kısa süre içinde güncellenecek."
  }
}

Yanıt Alanları:

  • success: Başarıyla oluşturulan besleme sayısı
  • failed: Oluşturulamayan besleme sayısı
  • total: Sağlanan URL sayısı
  • results: Her URL için sonuçların dizisi
    • index: İstek dizisindeki sıfır tabanlı indeks
    • url: Doğrulanmış ve standartlaştırılmış URL
    • platform: Tespit edilen platform (tiktok, instagram, youtube vb.)
    • feedId: Oluşturulan beslemenin benzersiz kimliği
    • success: Beslemenin başarıyla oluşturulup oluşturulmadığı
    • skipped: (isteğe bağlı) Beslemenin zaten mevcut olduğu için atlanıp atlanmadığı
    • resumed: (isteğe bağlı) Durdurulmuş bir beslemenin yeniden başlatılıp başlatılmadığı
    • error: (isteğe bağlı) Oluşturma başarısızsa hata mesajı
  • errors: Başarısız URL’ler için hata dizisi

Örnek İstek

curl -X POST https://snstracker.com/api/v1/feeds \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@user/video/1234567890"
    ]
  }'

2. Beslemeleri Yenileme

En güncel verileri hemen almak için mevcut beslemeleri yenileyin. Yalnızca durumu "Pending" veya "Tracked" olan beslemeler yenilenebilir.

POST /api/v1/feeds/refresh

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "feedIds": ["feed_abc123xyz", "feed_def456uvw"]
}

Parametreler:

  • feedIds (gerekli): Yenilenecek besleme kimliklerinin dizisi

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "feedIds": ["feed_abc123xyz", "feed_def456uvw"],
    "total": 2,
    "message": "2 besleme başarıyla yenilendi"
  }
}

Yanıt Alanları:

  • success: Yenileme işleminin başarılı olup olmadığı
  • feedIds: Yenilenen besleme kimliklerinin dizisi
  • total: Yenilenen besleme sayısı
  • message: Başarı mesajı

Örnek İstek

curl -X POST https://snstracker.com/api/v1/feeds/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "feedIds": ["feed_abc123xyz"]
  }'

3. Kanal Oluşturma

Kanal URL’leri (hesap profilleri vb.) göndererek izleme kanalları oluşturun.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "urls": [
    "https://www.tiktok.com/@username",
    "https://www.instagram.com/username/"
  ],
  "collectionId": "coll_abc123xyz"
}

Parametreler:

  • urls (gerekli): İzlenecek kanal URL’lerinin dizisi. İstek başına en fazla 5 URL.
  • collectionId (isteğe bağlı): Kanalların ekleneceği koleksiyon kimliği. Sağlanmazsa ekibinizin varsayılan koleksiyonu kullanılır.

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@username",
        "platform": "tiktok",
        "channelId": "channel_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/username/",
        "platform": "instagram",
        "channelId": "channel_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Kanallar başarıyla oluşturuldu. Veriler kısa süre içinde güncellenecek."
  }
}

Yanıt Alanları:

  • success: Başarıyla oluşturulan kanal sayısı
  • failed: Oluşturulamayan kanal sayısı
  • total: Sağlanan URL sayısı
  • results: Her URL için sonuçların dizisi
    • index: İstek dizisindeki sıfır tabanlı indeks
    • url: Doğrulanmış ve standartlaştırılmış URL
    • platform: Tespit edilen platform (tiktok, instagram, youtube vb.)
    • channelId: Oluşturulan kanalın benzersiz kimliği
    • success: Kanalın başarıyla oluşturulup oluşturulmadığı
    • skipped: (isteğe bağlı) Kanalın zaten mevcut olduğu için atlanıp atlanmadığı
    • resumed: (isteğe bağlı) Durdurulmuş bir kanalın yeniden başlatılıp başlatılmadığı
    • error: (isteğe bağlı) Oluşturma başarısızsa hata mesajı
  • errors: Başarısız URL’ler için hata dizisi

Örnek İstek

curl -X POST https://snstracker.com/api/v1/channels \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@username"
    ]
  }'

4. Kanalları Yenileme

En güncel verileri hemen almak için mevcut kanalları yenileyin. Yalnızca durumu "Pending" veya "Tracked" olan kanallar yenilenebilir.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels/refresh

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "channelIds": ["channel_abc123xyz", "channel_def456uvw"]
}

Parametreler:

  • channelIds (gerekli): Yenilenecek kanal kimliklerinin dizisi

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "channelIds": ["channel_abc123xyz", "channel_def456uvw"],
    "total": 2,
    "message": "2 kanal başarıyla yenilendi"
  }
}

Yanıt Alanları:

  • success: Yenileme işleminin başarılı olup olmadığı
  • channelIds: Yenilenen kanal kimliklerinin dizisi
  • total: Yenilenen kanal sayısı
  • message: Başarı mesajı

Örnek İstek

curl -X POST https://snstracker.com/api/v1/channels/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "channelIds": ["channel_abc123xyz"]
  }'

5. Besleme Senkronizasyonu

Scrapy servisinden besleme verisini doğrudan senkronize edin. Bu uç nokta en güncel besleme verisini hemen getirir ve senkronizasyon başarıyla tamamlandığında kredi tüketir. Takımın tüm üyeleri ve API anahtarları tüm senkronizasyon uç noktaları için tek bir sınırı paylaşır. Ortak sınır Başlangıç veya geçerli abonelik yoksa 1, Standart için 5 ve Premium için 10 eşzamanlı istektir.

⚠️ Önemli Not: Bu senkronizasyon uç noktası bağımsızdır ve web platformu ile ENTEGRASYON SAĞLAMAZ. Senkronizasyon işlemleri:

  • Web panelinde besleme kayıtlarını oluşturmaz veya güncellemez
  • Beslemeler listenizde veya koleksiyonlarınızda görünmez
  • Webhook’ları veya bildirimleri tetiklemez
  • Yalnızca alınan veriyi API yanıtında doğrudan döndürür

Bu uç nokta, API üzerinden tek seferlik veri alma için tasarlanmıştır. Web platformunda görünen kalıcı izleme beslemeleri oluşturmak için Besleme Oluşturma uç noktasını kullanın.

POST /api/v1/feeds/sync

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "url": "https://www.tiktok.com/@user/video/1234567890"
}

Parametreler:

  • url (gerekli): Senkronize edilecek besleme URL’si. Geçerli ve boş olmayan bir dize olmalıdır.

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@user/video/1234567890",
    "feedInfo": {
      "feed_id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "url": "https://www.tiktok.com/@user/video/1234567890",
      "views": 1000000,
      "likes": 200000,
      "comments": 1000,
      "shares": 2000,
      "bookmarks": 200,
      "engagement": 512000,
      "description": "Video açıklaması",
      "hashtags": ["tag1", "tag2"],
      "publish_at": 1234567890
    }
  }
}

Yanıt Alanları:

  • success: Senkronizasyon işleminin başarılı olup olmadığı
  • url: Senkronize edilen besleme URL’si
  • feedInfo: Met­rikler, açıklama, hashtag’ler vb. dahil tam besleme bilgisi

Hata Yanıtları:

  • 429 Too Many Requests: Takımın ortak sınırına ulaşıldı. İstek kuyruğa alınmaz.
  • 400 Bad Request: Yetersiz kredi veya geçersiz URL

Örnek İstek

curl -X POST https://snstracker.com/api/v1/feeds/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@user/video/1234567890"
  }'

6. Kanal Senkronizasyonu

Scrapy servisinden kanal verisini doğrudan senkronize edin. Bu uç nokta en güncel kanal verisini hemen getirir ve senkronizasyon başarıyla tamamlandığında kredi tüketir. Takımın tüm üyeleri ve API anahtarları tüm senkronizasyon uç noktaları için tek bir sınırı paylaşır. Ortak sınır Başlangıç veya geçerli abonelik yoksa 1, Standart için 5 ve Premium için 10 eşzamanlı istektir.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

⚠️ Önemli Not: Bu senkronizasyon uç noktası bağımsızdır ve web platformu ile ENTEGRASYON SAĞLAMAZ. Senkronizasyon işlemleri:

  • Web panelinde kanal kayıtlarını oluşturmaz veya güncellemez
  • Kanallar listenizde veya koleksiyonlarınızda görünmez
  • Webhook’ları veya bildirimleri tetiklemez
  • Yalnızca alınan veriyi API yanıtında doğrudan döndürür

Bu uç nokta, API üzerinden tek seferlik veri alma için tasarlanmıştır. Web platformunda görünen kalıcı izleme kanalları oluşturmak için Kanal Oluşturma uç noktasını kullanın.

POST /api/v1/channels/sync

İstek

Başlıklar:

  • X-API-Key: API anahtarınız (gerekli)
  • Content-Type: application/json

İstek Gövdesi:

{
  "url": "https://www.tiktok.com/@username"
}

Parametreler:

  • url (gerekli): Senkronize edilecek kanal URL’si. Geçerli ve boş olmayan bir dize olmalıdır.

Yanıt

Başarılı Yanıt (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@username",
    "channelInfo": {
      "id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "username": "username",
      "nickname": "Kullanıcı Adı",
      "description": "Kanal açıklaması",
      "followers": 1000000,
      "followings": 2000,
      "likes": 200000000,
      "total_count": 1000,
      "track_count": 1000,
      "status": 1
    }
  }
}

Yanıt Alanları:

  • success: Senkronizasyon işleminin başarılı olup olmadığı
  • url: Senkronize edilen kanal URL’si
  • channelInfo: Metrikler, açıklama vb. dahil tam kanal bilgisi

Hata Yanıtları:

  • 429 Too Many Requests: Takımın ortak sınırına ulaşıldı. İstek kuyruğa alınmaz.
  • 400 Bad Request: Yetersiz kredi veya geçersiz URL

Örnek İstek

curl -X POST https://snstracker.com/api/v1/channels/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username"
  }'

7. Kanal içeriğini senkronize et

Instagram ve Reels için istek başına en fazla 12 öğe içeren tek sayfa döndürür; otomatik sayfalama yapmaz. instagram görsel, video ve carousel gönderilerini; reels Reels videolarını döndürür.

POST /api/v1/channels/feeds/sync
X-API-Key: your-api-key
Content-Type: application/json

Request and pagination

{
  "platform": "instagram",
  "channel_name": "instagram"
}
  • count, bu sayfada istenen öğe sayısını belirten isteğe bağlı bir pozitif tam sayıdır; varsayılan değeri yoktur. Sınırlar platforma göre değişir: Instagram ve Reels istek başına en fazla 12 öğe döndürür, daha az öğe de dönebilir. Belirtilmezse platformun varsayılan sayfa boyutu kullanılır.
  • İlk sayfada cursor göndermeyin. Sonraki sayfada önceki next_cursor değerini değiştirmeden gönderin; platform ve channel_name aynı kalmalıdır. Sonda: has_more=false, next_cursor=null.
{
  "platform": "instagram",
  "channel_name": "instagram",
  "cursor": "previous-next-cursor"
}

Başarıyla alınan her sayfa, boş sayfalar dahil, 10 kredi tutar. Yalnızca başarısız istekler ücretsizdir; istek öncesi en az 10 kredi gerekir. Diğer senkronizasyon API’leriyle takım eşzamanlılık sınırını paylaşır ve panel kaydı oluşturmaz.

Response example (placeholder cursor) — reels, lunacut.edit, count=1

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "platform": "reels",
    "channel_name": "lunacut.edit",
    "channel_url": "https://www.instagram.com/lunacut.edit/",
    "requested_count": 1,
    "returned_count": 1,
    "has_more": true,
    "next_cursor": "cursor-from-response",
    "items": [
      {
        "feed_id": "4009169989985582972",
        "platform": 5,
        "platform_name": "reels",
        "type": "video",
        "url": "https://www.instagram.com/reel/Dejbt1JPz98/",
        "author_username": "lunacut.edit",
        "publish_at": 1792150387,
        "duration": 70.077,
        "view_count": 310475
      }
    ]
  }
}

platform and channel_name are required. channel_name is the username, not the display name; leading @ is accepted and dots are preserved. requested_count is null when count is omitted; returned_count equals items.length. Unknown metrics/timestamps are null. Posts may lack timestamps and carousel details. items uses the existing feed fields, including video_url, image_urls and cover_url; the example shows only selected fields. publish_at is Unix seconds and duration is seconds. Upstream order is preserved, without a most-popular sorting option; deduplicate across pages by feed_id. Empty pages can still have a next cursor; a carousel counts as one post.

items içindeki görüntülenme (view_count), beğeni (like_count), kaydetme (bookmark_count) ve yorum (comment_count) gibi metrikler, platforma ve kanal listesinin sunduğu verilere bağlıdır. Bazı metrikler kullanılamayabilir. Alınamayan metrikler null olarak döner; bu, sıfır anlamına gelmez.

Listede bulunmayan metrikleri sorgulamak için öğenin url değerini istek gövdesindeki url alanına yazarak POST /api/v1/feeds/sync uç noktasını ayrıca çağırın. Ayrıntı isteği, o uç noktanın kurallarına göre ayrıca ücretlendirilir. Sonuçlar platformun sağladığı verilere bağlıdır; eksik metriklerin tamamının alınması garanti edilmez.

HTTP: 400 invalid input/cursor or insufficient initial credits; 401 invalid API key; 403 disabled team or inaccessible channel; 402 insufficient credits at settlement; 429 team concurrency limit (Retry-After: 1); 502 upstream/invalid page; 503 service unavailable; 504 timeout.

8. Ek profil bilgilerini getir

POST /api/v1/channels/about/sync

Yalnızca Instagram ve Reels. /api/v1/channels/sync ile aynı zorunlu url kullanılır: https://www.instagram.com/lunacut.edit/ veya https://www.instagram.com/lunacut.edit/reels/. platform, count, cursor gerekmez. Gönderi URL’leri ve diğer platformlar desteklenmez.

curl -X POST https://snstracker.com/api/v1/channels/about/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/lunacut.edit/"}'

Başarılı her istek 80 kredi tutar; alanlar null olsa da ücret alınır. Hatalar ücretsizdir; önceden en az 80 kredi gerekir. Tüm senkron API’lerle takım eşzamanlılık limiti paylaşılır: Starter/aktif abonelik yok 1, Standard 5, Premium 10. Panel kaydı veya webhook oluşturulmaz.

Örnek yanıt; alanların kullanılabilirliği hesabın açık bilgilerine bağlıdır.

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.instagram.com/lunacut.edit/",
    "channelAbout": {
      "platform": 6,
      "platform_name": "instagram",
      "username": "lunacut.edit",
      "channel_url": "https://www.instagram.com/lunacut.edit/",
      "country": "Brazil",
      "country_visible": true,
      "date_joined": "2020-05",
      "date_joined_text": "May 2020"
    }
  }
}

country: herkese açık ülke/bölge, yalnızca country_visible=true ise; gerçek zamanlı IP konumu değildir. country_visible: görünürlük veya bilinmiyorsa null. date_joined: katılım ayı (YYYY-MM), eksik/tanınmıyorsa null. date_joined_text: özgün tarih metni veya null. Bio, takipçi sayısı ve eski adlar dahil değildir.

400 / 401 / 402 / 403 / 429 (Retry-After: 1) / 502 / 503 / 504.

Webhook Entegrasyonu

SNSTracker, izlenen içerik yapılandırdığınız eşik değerlerini karşıladığında gerçek zamanlı bildirimler almak için webhook’ları destekler. Webhook’ları şu bildirimleri almak için yapılandırabilirsiniz:

  • Besleme güncellemeleri: Görüntüleme sayısı ve etkileşim (beğeni + yorum + paylaşım) belirlediğiniz eşik kadar arttığında
  • Kanal güncellemeleri: Takipçi, takip edilen veya beğeni sayısı belirlediğiniz eşik kadar arttığında

Webhook Kurulumu

  1. Webhook hedeflerini yapılandırın koleksiyon ayarlarınızda
  2. Bildirimleri etkinleştirin koleksiyon yapılandırmanızda
  3. İzlemek istediğiniz metrikler için eşikleri belirleyin

Webhook yapılandırması için ayrıntılı talimatlar için lütfen Webhook Yapılandırma Kılavuzu sayfasına bakın.

Hata Yanıtları

Tüm uç noktalar aşağıdaki hata yanıtlarını döndürebilir:

401 Unauthorized - API Anahtarı Eksik

{
  "code": -1,
  "message": "X-API-Key header is required"
}

401 Unauthorized - Geçersiz API Anahtarı

{
  "code": -1,
  "message": "Invalid API key"
}

400 Bad Request - Geçersiz Girdi

{
  "code": -1,
  "message": "Invalid request: urls must be an array"
}

400 Bad Request - Çok Fazla URL (Besleme Oluşturma)

{
  "code": -1,
  "message": "Maximum 200 URLs allowed per request"
}

400 Bad Request - Çok Fazla URL (Kanal Oluşturma)

{
  "code": -1,
  "message": "Maximum 200 URLs allowed per request"
}

400 Bad Request - Yetersiz Kredi

{
  "code": -1,
  "message": "Insufficient credits. Required: 10, Available: 5"
}

429 Too Many Requests - Takım senkronizasyon eşzamanlılığı

{
  "code": -1,
  "message": "Maximum concurrent sync requests (1) reached for this team. Currently active: 1. Wait for a request to complete, or contact official support to increase the limit."
}

403 Forbidden - Geçersiz Koleksiyon

{
  "code": -1,
  "message": "Collection not found or does not belong to your team"
}

404 Not Found

{
  "code": -1,
  "message": "No feeds found"
}

veya

{
  "code": -1,
  "message": "No channels found"
}

Kullanım Örnekleri

Python Örneği - Besleme Oluşturma

import requests

url = "https://snstracker.com/api/v1/feeds"
headers = {
    "X-API-Key": "your-api-key-here",
    "Content-Type": "application/json"
}
data = {
    "urls": [
        "https://www.tiktok.com/@user/video/1234567890",
        "https://www.instagram.com/p/ABC123/"
    ]
}

response = requests.post(url, json=data, headers=headers)
result = response.json()

if result["code"] == 0:
    print(f"Başarıyla {result['data']['success']} besleme oluşturuldu")
    for feed in result["data"]["results"]:
        print(f"  - {feed['url']}: {feed['feedId']}")
else:
    print(f"Hata: {result['message']}")

JavaScript Örneği - Beslemeleri Yenileme

const response = await fetch('https://snstracker.com/api/v1/feeds/refresh', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your-api-key-here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    feedIds: ['feed_abc123xyz', 'feed_def456uvw'],
  }),
});

const result = await response.json();

if (result.code === 0) {
  console.log(`Başarıyla ${result.data.total} besleme yenilendi`);
  result.data.feedIds.forEach((feedId) => {
    console.log(`  - ${feedId}`);
  });
} else {
  console.error(`Hata: ${result.message}`);
}

Önemli Notlar

  1. URL Doğrulama: Tüm URL’ler oluşturulmadan önce otomatik olarak doğrulanır. Geçersiz URL’ler reddedilir.

  2. Yinelenen Öğeler: Aynı URL’ye sahip bir öğe koleksiyonda zaten varsa:

    • Aktifse, atlanır (skipped: true olarak işaretlenir)
    • Durdurulmuşsa, yeniden başlatılır (resumed: true olarak işaretlenir)

  3. Veri Toplama: Başarılı oluşturma sonrası öğeler veri toplama için sıraya alınır. Veriler oluşturmanın kısa süre ardından kullanılabilir.

  4. Yenileme Durumu: Yalnızca durumu "Pending" veya "Tracked" olan öğeler yenilenebilir. Diğer durumlara sahip öğeler filtrelenir.

  5. Krediler: İstek yapmadan önce yeterli krediniz olduğundan emin olun. Senkronizasyon işlemleri, veriler başarıyla alındığında kredileri anında tüketir. Xiaohongshu channel tasks are priced separately and currently cost 10 credits per successful request. /api/v1/channels/feeds/sync: Başarıyla alınan her sayfa, boş sayfalar dahil, 10 kredi tutar. Yalnızca başarısız istekler ücretsizdir; istek öncesi en az 10 kredi gerekir. Diğer senkronizasyon API’leriyle takım eşzamanlılık sınırını paylaşır ve panel kaydı oluşturmaz. /api/v1/channels/about/sync: Başarılı her istek 80 kredi tutar; alanlar null olsa da ücret alınır. Hatalar ücretsizdir; önceden en az 80 kredi gerekir. Tüm senkron API’lerle takım eşzamanlılık limiti paylaşılır: Starter/aktif abonelik yok 1, Standard 5, Premium 10. Panel kaydı veya webhook oluşturulmaz.

  6. Takım senkronizasyon eşzamanlılığı (/api/v1/feeds/sync + /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync): Takımın tüm üyeleri ve API anahtarları tüm senkronizasyon uç noktaları için tek bir sınırı paylaşır. Ortak sınır Başlangıç veya geçerli abonelik yoksa 1, Standart için 5 ve Premium için 10 eşzamanlı istektir. Sınır geçerli aboneliğe göre otomatik değişir; resmî desteğin takıma özel ayarı önceliklidir. Takım sınırını artırmak için resmî destekle iletişime geçin.

  7. Senkronizasyon vs Oluşturma: Senkronizasyon uç noktaları (/api/v1/feeds/sync ve /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync) bağımsızdır ve web platformu ile ENTEGRASYON SAĞLAMAZ. Yalnızca API yanıtında veri döndürür ve panelde kayıt oluşturmaz. Web platformunda görünen kalıcı izleme öğeleri oluşturmak için Create uç noktalarını (/api/v1/feeds ve /api/v1/channels) kullanın.

  8. Yeniden deneme: 429 sonrasında etkin bir isteğin bitmesini bekleyin ve Retry-After başlığına uyarak artan aralıklarla yeniden deneyin. 503 sonrasında daha sonra deneyin.

  9. Desteklenen Platformlar: TikTok, Instagram, YouTube ve diğer büyük sosyal medya platformları.

Sorun Giderme

Sorun: "X-API-Key header is required"
Çözüm: İsteğinize X-API-Key başlığını eklediğinizden emin olun.

Sorun: "Invalid API key"
Çözüm: API anahtarınızın doğru olduğunu doğrulayın. Ayarlar → API Anahtarları bölümünden yeni bir anahtar oluşturabilirsiniz.

Sorun: "Maximum URLs allowed per request"
Çözüm: URL’lerinizi birden fazla isteğe bölün. Beslemeler istek başına en fazla 200 URL, kanallar ise en fazla 5 URL kabul eder.

Sorun: "No collection found"
Çözüm: Önce panelde bir koleksiyon oluşturun veya mevcut bir koleksiyon kimliği belirtin.

Sorun: "Insufficient credits"
Çözüm: Daha fazla kredi satın alın veya abonelik planınızı kontrol edin.

Sorun: "No refreshable items found"
Çözüm: Yalnızca durumu "Pending" veya "Tracked" olan öğeler yenilenebilir. Öğelerinizin durumunu kontrol edin.

Sorun: Bazı URL’ler doğrulamadan geçmiyor
Çözüm: Yanıttaki errors dizisini kontrol ederek spesifik hata mesajlarını inceleyin. URL’lerin desteklenen platformlardan olduğundan ve herkese açık erişilebilir olduğundan emin olun.

Webhook Yapılandırma Kılavuzu

Next Page

On this page

Genel Bakış
Kimlik Doğrulama
API Uç Noktaları
1. Besleme Oluşturma
İstek
Yanıt
Örnek İstek
2. Beslemeleri Yenileme
İstek
Yanıt
Örnek İstek
3. Kanal Oluşturma
İstek
Yanıt
Örnek İstek
4. Kanalları Yenileme
İstek
Yanıt
Örnek İstek
5. Besleme Senkronizasyonu
İstek
Yanıt
Örnek İstek
6. Kanal Senkronizasyonu
İstek
Yanıt
Örnek İstek
7. Kanal içeriğini senkronize et
Request and pagination
Response example (placeholder cursor) — reels, lunacut.edit, count=1
8. Ek profil bilgilerini getir
Webhook Entegrasyonu
Webhook Kurulumu
Hata Yanıtları
401 Unauthorized - API Anahtarı Eksik
401 Unauthorized - Geçersiz API Anahtarı
400 Bad Request - Geçersiz Girdi
400 Bad Request - Çok Fazla URL (Besleme Oluşturma)
400 Bad Request - Çok Fazla URL (Kanal Oluşturma)
400 Bad Request - Yetersiz Kredi
429 Too Many Requests - Takım senkronizasyon eşzamanlılığı
403 Forbidden - Geçersiz Koleksiyon
404 Not Found
Kullanım Örnekleri
Python Örneği - Besleme Oluşturma
JavaScript Örneği - Beslemeleri Yenileme
Önemli Notlar
Sorun Giderme