CSV Dışa Aktarma ve REST API Nedir? Ne İşe Yarar?

Bir firma veritabanının değeri, o veriyi ekranda görebilmenizden çok, veriyi kendi araçlarınıza taşıyabilmenizden gelir. Excel'de bir listeyi süzmek, CRM'inize yeni potansiyel müşteriler aktarmak, mail aracınızı beslemek ya da kendi uygulamanızla otomatik veri çekmek... Bunların hepsi verinin "dışarı akmasını" gerektirir. İşte tam bu noktada karşınıza iki temel yöntem çıkar: panelden CSV/Excel dışa aktarma ve REST API.

Bu iki kavram kulağa teknik gelebilir ama aslında çok sadedir. Bu rehberde ikisini de sıfırdan, jargon kullanmadan açıklayacağız. Hem Excel'de liste indirmek isteyen bir satış müdürü, hem de kendi yazılımına firma verisi entegre etmek isteyen bir geliştirici bu yazıda kendine hitap eden bölümü bulacak. Sonunda hangi durumda hangisini seçmeniz gerektiğini ve FreshSignal ile bunları adım adım nasıl yapacağınızı net şekilde bileceksiniz.

CSV Nedir? Dosya Formatı ve Nerede Açılır

CSV, İngilizce "Comma-Separated Values" yani "virgülle ayrılmış değerler" ifadesinin kısaltmasıdır. Adından da anlaşılacağı gibi, bir tablo verisini olabildiğince sade bir metin dosyasında saklamanın yoludur. Her satır bir kaydı (örneğin bir firmayı), her satırdaki virgülle ayrılmış parçalar da o kaydın sütunlarını (ünvan, il, ilçe, sektör gibi) temsil eder.

CSV'nin en güçlü yanı evrensel olmasıdır. Neredeyse her tablo programı, her CRM, her veri aracı CSV dosyasını okuyabilir. Dosyayı bilgisayarınıza indirdiğinizde onu şuralarda açabilirsiniz: Microsoft Excel, Google Sheets, Apple Numbers, LibreOffice Calc, ayrıca hemen her CRM ve e-posta pazarlama aracının "içe aktar" (import) ekranı. Yani CSV, farklı sistemler arasındaki ortak dildir.

• Basit metin dosyasıdır; özel bir yazılım gerektirmez, hatta Not Defteri ile bile açılır.
• Boyutu küçüktür; on binlerce satır bile hızlıca aktarılır.
• Her sistemde okunur; taşınabilirliği en yüksek veri formatıdır.
• Excel ile açtığınızda otomatik olarak sütunlara yerleşir ve tablo gibi görünür.

CSV/Excel Dışa Aktarma Ne İşe Yarar?

Dışa aktarma (export), bir veritabanındaki kayıtları filtreleyip bir dosyaya döküp bilgisayarınıza indirmek demektir. FreshSignal'de bu, 7,9 milyonluk firma veritabanını süzüp yalnızca işinize yarayan firmaları bir CSV veya XLSX dosyası olarak almanız anlamına gelir. Ekranda tek tek bakmak yerine, hedeflediğiniz kitleyi tek dosyada elde edersiniz.

Bu, özellikle satış ve pazarlama ekipleri için çok pratiktir. Bir kez filtreyi kurar, dosyayı indirir ve ondan sonra veriyi kendi tanıdığınız araçta (Excel, CRM) istediğiniz gibi kullanırsınız. İnternet bağlantısına, panele tekrar girmeye gerek kalmaz; dosya sizindir.

• Hedef müşteri listesi çıkarma: belirli bir il, ilçe ve sektördeki firmaları tek dosyada toplama.
• Kendi CRM'inize toplu içe aktarma: yeni potansiyel müşterileri sisteminize aktarma.
• E-posta/mail aracını besleme: filtrelenmiş firmaları kampanya listenize taşıma.
• Excel'de analiz ve raporlama: pivot tablo, grafik ve segmentasyon çalışmaları.
• Saha/telefon ekibine dağıtım: bölge bölge listeler hazırlayıp paylaşma.

FreshSignal'de Dışa Aktarma Nasıl Çalışır?

FreshSignal panelinde dışa aktarma süreci dört basit adımdan oluşur: önce filtrelersiniz, sonra kolonları seçersiniz, ardından CSV veya XLSX olarak indirirsiniz ve son olarak dosyayı Excel'de, CRM'inizde ya da analiz aracınızda kullanırsınız. Aşağıdaki şema bu akışı özetliyor.

1. Filtreleme

Panelde Firma Verisi → Dışa aktarma bölümüne girip 7,9 milyonluk veritabanını daraltırsınız. Kullanabileceğiniz filtreler şunlardır: ülke (Türkiye veya Birleşik Krallık), il, ilçe, NACE sektör kodu (2, 4 veya 6 haneli), firma tipi, dijital varlık (web sitesi / telefon / e-posta var mı yok mu), ünvanda geçen kelime ve liste tarihi aralığı. Bu filtreleri birleştirerek çok keskin bir hedef kitle tanımlayabilirsiniz.

2. Kolon seçimi

Dosyada hangi bilgilerin yer alacağını siz belirlersiniz. Kolonlar gruplar halinde sunulur: temel bilgi, adres, iletişim ve dijital varlık grupları. İhtiyacınız olmayan sütunları dışarıda bırakarak dosyayı sade ve amaca uygun tutabilirsiniz.

3. Biçim seçimi ve indirme

Dosyayı CSV veya XLSX (Excel) olarak indirebilirsiniz; ikisi de gerçek seçeneklerdir. Tek bir indirmede en fazla 50.000 satır alırsınız (senkron indirme). Daha büyük sonuç kümeleri için endişelenmeyin: "Sayfa 2'yi indir" seçeneğiyle veriyi dilim dilim, sayfa sayfa alabilirsiniz.

4. Kaydetme ve geçmiş

Kurduğunuz filtreyi Kayıtlı listeler altında saklayabilirsiniz; böylece her seferinde baştan filtre kurmanız gerekmez. Ayrıca indirme geçmişi tutulur, daha önce hangi listeyi ne zaman aldığınızı görebilirsiniz.

REST API Nedir? (Teknik Olmayanlar İçin de)

API, "Application Programming Interface" yani "uygulama programlama arayüzü" demektir. Çok teknik gelmesin: bir API'yi, iki yazılımın birbiriyle konuşmasını sağlayan bir sipariş penceresi gibi düşünün. Siz pencereye "İstanbul'daki inşaat firmalarını ver" diye bir istek gönderirsiniz, karşı taraf da size düzenli bir cevap döner. REST API ise bu konuşmanın internet üzerinden, web adresleri (URL) kullanılarak yapılan yaygın ve standart bir türüdür.

Bu konuşmanın iki tarafı vardır. Sizin gönderdiğiniz mesaja istek (request) denir. Karşı tarafın geri döndüğü mesaja da yanıt (response) denir. Yanıt genellikle JSON adı verilen bir formatta gelir; JSON, verinin "anahtar: değer" çiftleriyle düzenlenmiş, hem insanın hem programın kolayca okuyabildiği bir metin biçimidir. Örneğin bir firma JSON'da "il": "İstanbul" gibi görünür.

Peki karşı taraf isteğin sizden geldiğini nereden bilir? İşte burada Bearer anahtar devreye girer. Her isteğe, size özel bir kimlik kartı gibi çalışan bir API anahtarı eklersiniz. FreshSignal'de bu anahtar fs_live_... formatındadır ve isteğin başlığına Authorization: Bearer fs_live_... şeklinde eklenir. Anahtar sizi tanıtır ve yetkinizi doğrular.

Firma Verisi API'si Ne İşe Yarar?

Dışa aktarma "bir kerede dosya indirme" işiyken, API otomasyon ve entegrasyon içindir. Bir insanın panele girip dosya indirmesine gerek kalmadan, sizin yazılımınız arka planda firma verisini kendi kendine çekebilir. Bu, tekrar eden ya da programatik işler için biçilmiş kaftandır.

• Kendi uygulamanıza firma arama özelliği ekleme: kullanıcı il/ilçe/sektör seçtiğinde canlı sonuç gösterme.
• CRM'inizi otomatik besleme: yeni eklenen firmaları düzenli aralıklarla kendi sisteminize çekme.
• İç panellerinizde raporlama: kendi BI aracınızın firma verisini API'den okuması.
• Zenginleştirme: elinizdeki bir firmayı arayıp eksik il/ilçe/sektör bilgisini tamamlama.
• Düzenli senkronizasyon: veriyi güncel tutmak için periyodik (örneğin haftalık) çekim yapma.

FreshSignal REST API'sinin ana ucu firma aramadır, ancak yalnızca okuma ile sınırlı değildir. Basit CRM işlemleri için de uçlar sunar: kişi ekleyip güncelleyebilir ve firmaları/kişileri listelere üye yapabilirsiniz. Böylece API, hem veri okumak hem de kendi outreach akışınızı otomatikleştirmek için kullanılabilir.

Dışa Aktarma mı, API mı? Ne Zaman Hangisi?

İkisi de veriyi dışarı taşır ama farklı ihtiyaçlara hizmet eder. Kısaca: bir kerelik, elle iş için dışa aktarma; tekrar eden, otomatik iş için API. Aşağıdaki tablo kararınızı kolaylaştırır.

Çoğu ekip ikisini birlikte kullanır: hızlı bir liste ya da Excel analizi gerektiğinde dışa aktarma, sistemler arası kalıcı bağlantı gerektiğinde ise API. Biri diğerinin alternatifi değil, tamamlayıcısıdır.

5N1K ile CSV Dışa Aktarma ve API

Konuyu klasik 5N1K çerçevesiyle özetleyelim; hem hızlı bir hatırlatma hem de bütünü tek bakışta görme fırsatı.

Ne?

CSV dışa aktarma, filtrelenmiş firma verisini bir dosyaya (CSV/XLSX) döküp indirmektir. REST API ise firma verisine kod aracılığıyla, internet üzerinden erişip JSON yanıt almaktır.

Neden?

Veriyi ekranda görmek yetmez; onu kendi araçlarınıza (Excel, CRM, kendi uygulamanız) taşıyarak satış, pazarlama ve analiz işlerinizde kullanabilmek için.

Nasıl?

Dışa aktarmada: panelden filtrele, kolon seç, CSV/XLSX indir. API'de: panelden anahtar üret, isteğe Authorization: Bearer başlığını ekle, /api/v1/companies ucuna çağrı yap, JSON yanıtı işle.

Nerede?

Dışa aktarma panelde Firma Verisi → Dışa aktarma altında; API anahtarı üretimi Entegrasyonlar & API altında. API'nin temel adresi https://freshsignal.net.

Ne zaman?

Bir kerelik liste veya Excel analizi gerektiğinde dışa aktarma; tekrar eden, otomatik veya sistemler arası veri akışı gerektiğinde API.

Kim?

Dışa aktarmayı teknik bilgisi olmayan satışçı/pazarlamacı da kullanabilir; API'yi genellikle kendi yazılımına veri entegre eden geliştiriciler kullanır.

İyi Kullanım Senaryoları

Kendi CRM'inize aktarma

Belirli bir il, ilçe ve NACE sektöründeki firmaları filtreleyip CSV olarak indirin, ardından CRM'inizin "içe aktar" ekranından toplu yükleyin. Düzenli bir akış istiyorsanız aynı işi API'nin CRM uçlarıyla (POST /api/v1/crm/contacts) otomatikleştirebilirsiniz.

Mail/e-posta aracını besleme

"E-postası olan" firmaları dijital varlık filtresiyle süzüp listenizi çıkarın, e-posta pazarlama aracınıza aktarın. Böylece kampanyalarınızı hedefli ve temiz bir listeyle başlatırsınız.

BI ve analiz

Sektör ve bölge dağılımlarını incelemek için XLSX indirip Excel'de pivot tablo kurun; ya da kendi BI aracınızın API üzerinden veriyi periyodik çekmesini sağlayın. Pazar büyüklüğü, yoğunluk ve segment analizleri için idealdir.

Veriyi düzenli güncel tutma

Liste tarihi aralığı filtresiyle yalnızca yeni eklenen firmaları alıp mevcut listenize ekleyin. API tarafında ise tarih_baslangic parametresiyle yalnızca belirli tarihten sonraki kayıtları çekerek düzenli bir güncelleme akışı kurabilirsiniz.

FreshSignal ile Adım Adım: Dışa Aktarma

1. Panelde Firma Verisi → Dışa aktarma bölümüne girin.
2. Ülke, il, ilçe, NACE sektör kodu, firma tipi, dijital varlık, ünvanda geçen kelime ve liste tarihi filtrelerini kurun.
3. Dosyada yer alacak kolon gruplarını seçin (temel bilgi, adres, iletişim, dijital varlık).
4. Biçimi seçin: CSV veya XLSX.
5. İndirin. Tek indirme en fazla 50.000 satır verir; daha fazlası için 'Sayfa 2'yi indir' ile devam edin.
6. İsterseniz filtreyi Kayıtlı listeler altında saklayın; indirme geçmişi otomatik tutulur.

FreshSignal ile Adım Adım: API Anahtarı Üretme

1. Panelde Entegrasyonlar & API bölümüne girin.
2. Yeni bir API anahtarı üretin. Anahtar fs_live_... formatında oluşturulur.
3. Anahtar SADECE bir kez gösterilir; hemen güvenli bir yere kopyalayın. Sistemde yalnızca sha256 özeti saklanır, açık hali tekrar gösterilmez.
4. Anahtarı isteklerinizin başlığına Authorization: Bearer fs_live_... olarak ekleyin.
5. Gerektiğinde anahtarı iptal (revoke) edebilirsiniz; son kullanım tarihi de takip edilir.

Gerçek Bir API İsteği: curl Örneği

Aşağıda İstanbul'daki firmaları, sayfa başına 50 kayıt olacak şekilde çeken gerçek bir curl örneği var. Authorization başlığındaki anahtarı kendi fs_live_... anahtarınızla değiştirin. Bu istek GET /api/v1/companies ucuna gider.

curl -X GET \
  "https://freshsignal.net/api/v1/companies?ulke=T%C3%BCrkiye&il=%C4%B0stanbul&nace2=41&page=1&per_page=50" \
  -H "Authorization: Bearer fs_live_XXXXXXXXXXXXXXXXXXXX"

İsteğe ekleyebileceğiniz başlıca arama parametreleri: ulke, il, ilce, nace2, nace4, nace6, search, tarih_baslangic, tarih_bitis, page ve per_page (en fazla 100). Böylece dışa aktarmadaki filtreleme mantığının çoğunu programatik olarak da uygulayabilirsiniz.

API Yanıtı Nasıl Görünür? (JSON)

Yukarıdaki istek başarılı olursa, aşağıdaki gibi bir JSON yanıt alırsınız. Yanıt sayfalıdır: page, per_page ve total alanları toplam sonuç ve sayfalama bilgisini verir. data dizisinde her firma için temel alanlar bulunur.

{
  "data": [
    {
      "id": 123456,
      "slug": "ornek-insaat-anonim-sirketi",
      "unvan": "Örnek İnşaat Anonim Şirketi",
      "ulke": "Türkiye",
      "il": "İstanbul",
      "ilce": "Kadıköy",
      "nace_kodu": "41.20.01",
      "firma_tipi": "Anonim Şirket",
      "listing_date": "2026-05-14"
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 4820
}

Her firma nesnesi şu alanları içerir: id, slug, unvan, ulke, il, ilce, nace_kodu, firma_tipi ve listing_date. Sonuçlar arasında gezinmek için page değerini artırarak sonraki sayfaları çekersiniz; total alanı toplam kaç kaydın bulunduğunu söyler, böylece kaç sayfa çekmeniz gerektiğini hesaplayabilirsiniz.

Güvenlik: Anahtarınızı Nasıl Korursunuz?

API anahtarınız, hesabınıza erişim sağlayan bir şifre gibidir. Bu yüzden onu gizli tutmak kritiktir. Aşağıdaki basit kurallar sizi çoğu riskten korur.

• Anahtarı kimseyle paylaşmayın ve halka açık kod depolarına (örneğin GitHub) koymayın.
• Anahtarı doğrudan koda gömmek yerine sunucu ortam değişkeninde (environment variable) saklayın.
• Anahtarı yalnızca sunucu tarafında kullanın; tarayıcıda/istemci kodunda görünür bırakmayın.
• Sızdığından şüphelenirseniz panelden anahtarı hemen iptal (revoke) edip yenisini üretin.
• Son kullanım tarihi takip edildiği için beklenmedik erişimleri fark edebilirsiniz.

Fiyatlandırma ve Plan

Hem CSV/Excel dışa aktarma hem de API anahtarı ücretli planlarda sunulur. Başlangıç ($19) dahil tüm ödemeli planlar bu iki özelliği kapsar. Ücretsiz plan bulunmaz. Yani panelden liste indirmek de, kendi uygulamanıza API ile veri çekmek de aynı ücretli abonelik kapsamındadır.

Hangi planın size uyduğunu görmek için fiyatlandırma sayfasını inceleyebilir, ardından panelden dışa aktarma ve API bölümlerini kullanmaya başlayabilirsiniz. Filtreleme özelliklerini daha yakından tanımak için firma arama ve filtreleme rehberine göz atın.

Özet

Firma verisini işinize katmanın iki yolu var. CSV/Excel dışa aktarma, teknik bilgi gerektirmeden panelden filtreleyip dosya indirmenizi sağlar; bir kerelik listeler, Excel analizi ve CRM'e elle import için idealdir. REST API ise kendi yazılımınızın firma verisine programatik olarak erişmesini sağlar; otomasyon, entegrasyon ve düzenli senkron için doğru araçtır.

İkisi birbirinin alternatifi değil, tamamlayıcısıdır. FreshSignal her iki yolu da ücretli planlarda sunar: filtreli dışa aktarma (CSV veya XLSX, tek indirmede 50.000 satıra kadar) ve fs_live_... anahtarıyla korunan REST API. Hangi ölçekte çalışırsanız çalışın, veriyi kendi araçlarınıza taşımanın net bir yolu var.

Başlamak için rehber merkezimize göz atabilir veya doğrudan panele girip ilk listenizi indirebilirsiniz.