Şirket Zenginleştirme API Rehberi ve Örnekler

Şirket kimliği zenginleştirme hangi sorunu çözer?

Şirket adları konuşmada işe yarar, kalıcı veritabanı anahtarı olarak zayıftır. Aynı işletme tüzel kişi adı, marka, kısaltma, çevrilmiş ad veya farklı yazımla kaydedilebilir. Farklı işletmeler de benzer adları paylaşabilir.

İncelenen domain CRM temizliği ve sonraki araştırma için daha güçlü kimlik oluşturur. Aynı kuruluşa ait kayıtları birleştirirken, kanıt gerektiriyorsa marka ve bağlı şirketleri ayrı tutmayı sağlar.

Uç nokta yine de aday üretir. Son karardan onu kullanan uygulama sorumludur.

Şirket sorgusu nasıl gönderilir?

1–25 benzersiz adı JSON gövdesiyle gönderin. Yetkilendirme başlığı gerekmez:

POST https://tools-api.growthmarketing.ai/v1/company-search
Content-Type: application/json
Accept: application/json

{"names":["Popupsmart"]}

Başarılı yanıt, gönderilen her ad için bir sonuç satırı içerir:

{
  "success": true,
  "data": {
    "rows": [
      {
        "query": "Popupsmart",
        "status": "matched",
        "candidates": [
          {
            "name": "Popupsmart",
            "domain": "popupsmart.com",
            "logoUrl": "https://tools-api.growthmarketing.ai/v1/logo/popupsmart.com"
          }
        ]
      }
    ]
  }
}

İlişkili satırları tek istekte gruplayın ve HTTP 429 yanıtında Retry-After süresine uyun.

Zenginleştirme akışı hangi alanları saklamalıdır?

Eşleşmeyi incelemek veya geri almak için yeterli bağlamı koruyun:

Alan eksikse değer uydurmayın. Boş logo, yanlış şirkete ait varlığı eklemekten daha güvenlidir.

Birden çok ve boş sonuç nasıl yönetilmelidir?

Birden çok aday dönerse kaynak kayıttaki kanıtı karşılaştırın:

• iş e-postası veya mevcut web sitesi domaini;
• ülke, şehir veya pazar;
• ürün ya da marka sahipliği;
• ana şirket veya bağlı şirket ilişkisi;
• kimliği doğrulayan resmî sayfa.

Kanıt çelişiyorsa kaydı çözümlenmemiş bırakın. Boş dizi de aday bulunmadığı anlamına gelir; başarısız istekten farklıdır.

Entegrasyon hangi hata ve yeniden denemeleri desteklemelidir?

Zaman aşımı belirleyin; doğrulama, hız sınırı, sağlayıcı, sunucu ve ağ yanıtlarını ayrı yönetin. Yalnızca kısa süreli hataları üst sınır ve gecikmeyle yeniden deneyin. Hatalı girdi otomatik yeniden deneme döngüsüne girmemelidir.

Tekrarlanan çağrıları önlemek için kabul edilen kimlikleri aynı iş akışında önbelleğe alın. Şirket adı, domaini, sahipliği veya logosu değiştiğinde önemli kayıtların yenilenebilmesi için inceleme tarihi tutun.

Uç nokta sözleşmesi için şirket kimliği API referansını, çok sayıda adın görsel incelemesi için toplu şirket logo bulucuyu kullanın.