# Perplexity kaynaklarını nasıl gösterir?

Yayınlanma: 2026-11-09. Güncellenme: 2026-11-09. Yazan: Framepx Team.

Perplexity'nin API'si kaynaklı bir cevabı iki adımda kurar: web araması sonuçlar getirir, sonra bir model cevabı yazar ve bu sonuçlara numarayla işaret eder ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). Bir marka için işe yarayan kısım, belgelerin bir arama sonucunu neyin oluşturduğunu ve geliştiricinin onu dahil etmek ya da elemek için hangi denetimleri kullandığını göstermesidir.

![Kaynaklı bir cevap nasıl kurulur: soru bir web aramasına gider, sonuçlar numaralarla döner, bir model bu numaralara işaret eden işaretlerle cevabı yazar ve kaynaklar yanında listelenir.](/blog/perplexity-lead-tr.svg "Tek resimde kaynaklı cevap: arama, numaralı sonuçlar, bunlara geri işaret eden bir cevap.")

Aşağıda Perplexity belgelerinden gelen her bilgi kendi sayfasına bağlıdır. Bir markanın ne yapması gerektiğine dair her söz bizim yorumumuzdur ve her seferinde bunu belirtiriz. Baştan bir sınır: bunlar geliştirici belgeleridir. API'yi anlatırlar, telefonunuzdaki Perplexity uygulamasını değil ve sonuçların nasıl sıralandığı hakkında hiçbir şey söylemezler.

## Belgelerin anlattığı: iki yol, bir de kapanan yol

API platformunda tek anahtarın arkasında birkaç API var. Atıflar için ikisi önemli ([platforma genel bakış](https://docs.perplexity.ai/docs/getting-started/overview)):

- **Search API:** `title`, `url`, `date` ve bir metin `snippet` alanıyla JSON olarak sıralı web sonuçları. Model yok, üretilmiş cevap yok.
- **Agent API:** atıflı, bitmiş bir cevap. Model `web_search` aracını kullanabilir.

Eski yol Sonar Chat Completions idi. Cevapları, `[1][2][7]` gibi işaretler taşıyan metnin yanında URL'lerden oluşan bir `citations` listesi ve nesnelerden oluşan bir `search_results` listesi taşırdı ([Sonar hızlı başlangıç, eski](https://docs.perplexity.ai/docs/legacy/sonar/quickstart)). Belgeler şimdi Sonar Chat Completions desteğinin 27 Eylül 2026'da sona erdiğini, eşzamanlı ve akış istekleri Agent API isteklerine dönüştürülürken çalışmaya devam ettiğini söylüyor ([geçiş genel bakışı](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)). Bugün karşınıza çıkacak biçim Agent API'ninki, onu önce anlatıyoruz.

## Bir cevap kaynaklarını nasıl bulur

Agent API'de `web_search` istekteki bir araçtır. Aracı ne zaman çağıracağına model, isteminize ve talimatlarınıza bakarak karar verir ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). Belgelerin sıraladığı adımlar şöyle:

1. Model bir ya da daha fazla arama yapar. Sorgu birkaç biçimde yeniden yazılırsa sonuç bütçesi sorgular arasında bölünür ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)).
2. Yanıtta, son mesajdan önce bir `search_results` öğesi bulunabilir. Her sonucun bir `id` değeri vardır.
3. Cevap metni ayrı bir `message` öğesidir. `[n]` işaretleri bu metnin içindedir ve her biri `id` değeri `n` olan sonuca karşılık gelir ([geçiş rehberi](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)).

![Notlu bir yanıt: kısa bir istek, sonra yer tutucu mağazalardan üç numaralı sonuç içeren search_results öğesi, sonra 1 ve 2 numaralı sonuçlara işaret eden [1] ve [2] işaretli bir cevap cümlesi.](/blog/perplexity-response-tr.svg "Kaynaklı bir yanıtın biçimi. Alan adları yer tutucudur, yapı belgeleri izler.")

İki ayrıntı kolay gözden kaçar. Birincisi, işaretler garanti değildir: modelin işaret ekleyip eklemeyeceği "isteme bağlıdır" ve belgeler her kaydın `id` ile `url` alanlarını atıfların doğruluk kaynağı saymanızı söyler ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). `fast`, `low`, `medium` ve `high` çaba seviyeleri satır içi atıfları zaten içerir: `fast` seviyesinde `[1]` gibi numaralı, diğerlerinde `[web:1]` gibi türü belirtilmiş ([geçiş rehberi](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)). İkincisi, `fast` seviyesinin yayımlanmış varsayılan talimatları modele arama bilgisi kullanan her cümleye atıf vermesini, cümle başına en fazla üç kaynak göstermesini ve arama yapmadıysa atıf koymamasını söyler ([çaba seviyeleri](https://docs.perplexity.ai/docs/agent-api/effort)). Bu talimatlara göre atıflı bir cümlenin, aramanın bulduğu bir sonuca dayanması beklenir (bu bizim yorumumuz; işaretlerin kendisi isteme bağlıdır).

## Bir kaynak neye benzer

`search_results` içindeki her kaydın yedi alanı var ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)):

- `id`: bir atfın işaret ettiği sabit sıra numarası
- `url`: kaynak sayfanın kanonik adresi
- `title`: sayfa başlığı, kaynağın verdiği haliyle
- `snippet`: arama sırasında sayfadan çıkarılan alıntı metin
- `date`: sayfanın ilk yayımlandığı tarih, `YYYY-MM-DD` biçiminde
- `last_updated`: sayfanın son güncellendiği tarih
- `source`: sonucun geldiği yer, mesela `web`

Search API sayfası, `snippet` değerinin sorguyla ilgili ve bir token sınırında kesilmiş metin olduğunu, "boş bir dize olabileceğini" ekliyor; `date` ve `last_updated` de `null` olabilir ([Search API genel bakışı](https://docs.perplexity.ai/docs/search/overview)). Belgeler, bir snippet'in neden boş geldiğini söylemiyor.

## Geliştiricinin elindeki denetimler

API'yi çağıran biri, cevapların nereden geleceğini daraltabilir. Markaların nadiren gördüğü kısım budur.

| Denetim | Ne yapar | Sınır |
| --- | --- | --- |
| `search_domain_filter` | Yalnızca listedeki alan adlarını ya da URL'leri alır, ya da başına `-` koyarak eler | En fazla 20 kayıt, izin listesi ya da engel listesi, ikisi birden olmaz |
| `search_recency_filter` | Son `hour`, `day`, `week`, `month` ya da `year` içindeki sonuçları tutar | Tek değer |
| `search_after_date_filter`, `search_before_date_filter` | Yayın tarihi bir aralığa düşen sonuçları tutar | `MM/DD/YYYY` |
| `last_updated_after_filter`, `last_updated_before_filter` | İlk yayına değil, son güncellemeye göre süzer | `MM/DD/YYYY` |
| `search_language_filter` (Search API) | Yalnızca listedeki dillerdeki sonuçları döndürür | En fazla 20 ISO 639-1 kodu |
| `user_location` (Agent API) ya da `country` (Search API) | Sonuçları bir ülkeye, bölgeye ya da şehre göre şekillendirir | Ülke iki harfli kodla |
| `max_results` | Bir çağrının topladığı sonuç sayısı | Agent API aracında 1 ila 50; Search API web aramasında 1 ila 20 |

Kaynaklar: [Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search), [Search API genel bakışı](https://docs.perplexity.ai/docs/search/overview), [alan adı filtresi](https://docs.perplexity.ai/docs/search/filters/domain-filter), [tarih filtreleri](https://docs.perplexity.ai/docs/search/filters/date-time-filters), [dil filtresi](https://docs.perplexity.ai/docs/search/filters/language-filter).

Alan adı filtresi alan adı düzeyinde (`wikipedia.org`) ya da URL düzeyinde çalışır; belgeler bir `.gov` kaydını da gösterir ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). Güncellik pencereleri son bir saate, 24 saate, 7 güne, 30 güne ve 365 güne karşılık gelir.

![Bir huni: bütün web sayfaları alan adı filtresi, güncellik ya da tarih filtresi, dil filtresi ve konum filtresinden geçerek modelin okuduğu küçük sonuç kümesine iner.](/blog/perplexity-controls-tr.svg "Geliştiricinin koyduğu her denetim, model hiçbir şey okumadan önce sayfaları eler.")

Filtreler birlikte kullanılabilir: belgeler, birleştirmelerine istek başına bir sınır olmadığını söylüyor ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). Sınırların büyüklüğü okumaktan çok görerek anlaşılır.

![İki küçük çubuk grafik: istek başına Search API sınırları, 5 sorgu, 20 sonuç, 20 alan adı, 20 dil; ve beş güncellik penceresi, bir saatten 365 güne log ölçekte.](/blog/perplexity-limits-tr.svg "İstek başına belgelenmiş sınırlar ve güncellik pencereleri. Birimler farklı, o yüzden iki panel.")

## Bir marka bundan ne öğrenir (bizim yorumumuz)

Belgeler bir markaya nasıl atıf alacağını anlatmaz. Orada bir sayfa göndermenin, yer satın almanın ya da dahil edilmeyi istemenin yolu yok. Gösterdikleri, çalışan mekanizmadır. Onu okuyunca beş sonuç çıkarırız ve hiçbiri Perplexity'nin verdiği bir söz değildir.

1. **Snippet için yazın.** `snippet`, sorgu için sayfadan çıkarılan metindir. Cevabını sayfanın üstünde açıkça söyleyen bir sayfa, bu çıkarıma malzeme verir. Perplexity'nin metni nasıl seçtiğini test etmedik.
2. **Gerçek bir başlık koyun.** `title`, kaynağın verdiği haliyle döner ve okuyucunun işaretin yanında gördüğü şeydir.
3. **Sayfaları dürüstçe tarihleyin ve güncelleyin.** `date` ve `last_updated` birer alandır, tarih ve güncellik filtreleri bunlara bakar. Belgeler, `null` tarihli bir sayfanın filtre altında nasıl ele alındığını söylemiyor; buna güvenmeyin.
4. **Tek soru için birkaç arama bekleyin.** Model sorguyu yeniden yazabilir. Sayfada bir sorunun yakın söyleniş biçimlerini de karşılayın, yalnızca birini değil.
5. **Müşterinizin dilinde yayımlayın.** Search API'de bir dil filtresi var; geliştirici Türkçe bir soruyu Türkçe sonuçlarla sınırlayabilir. Türkçe alıcının Türkçe bir sayfaya ihtiyacı var.

Ajanslar için pratik adım, tahmin etmek değil bakmaktır. Kategorinizin sorularını Search API'den ya da `web_search` içeren bir Agent API çağrısından geçirin; hangi `url` değerlerinin, hangi tarihlerle ve hangi `snippet` ile döndüğünü okuyun. Belgeler `web_search` için 1.000 çağrı başına 2,50 dolar, `search_type: "fast"` ile 1,00 dolar fiyat veriyor, model token'ları ayrıca ([Web Search belgesi](https://docs.perplexity.ai/docs/agent-api/tools/web-search)). Bunu yapan bir betik, [Claude Code](/tr/blog/claude-code-nedir-pazarlamaci-ve-reklamci-icin-ne-yapar) gibi bir araca uygun bir iştir. Asistanların tamamını görmek için [ürünlerin yapay zeka cevaplarında nasıl göründüğüne](/tr/blog/urunler-yapay-zeka-cevaplarinda-nasil-gorunur) bakın.

## Bilmediğimiz şeyler

- Sonuçların nasıl sıralandığı. Search API sayfaları kendi sonuçlarına "sıralı" der ve orada durur.
- Perplexity uygulamasının API ile aynı ayarları kullanıp kullanmadığı. Belgeler API'yi anlatır ve Sonar içine yerleşik web aramasının artık `web_search` aracı olarak sunulduğunu söyler ([geçiş rehberi](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)).
- Belirli bir sitenin ne sıklıkla atıf aldığı. Bu sayfalarda bunu anlatan bir rakam yok, o yüzden biz de vermiyoruz.

Atıf almak işin yarısı. Okuyucunun indiği sayfa ya da ardından gelen reklam da ayakta kalmalı: harcamadan önce bir reklamın kreatifini ücretsiz [kreatif skoru](/tr/tools/creative-score) ile kontrol edebilirsiniz. Ürünleriniz bir feed'de duruyorsa ve ondan bitmiş reklamlar istiyorsanız, Framepx'in işi budur: ürün feed'lerini reklama çeviren bir yapay zeka sistemi ([nasıl çalışır](/tr/how-it-works)).

## Sık sorulanlar

**Perplexity her zaman kaynak gösterir mi?**
Kural olarak değil. Agent API'de işaretler isteme bağlıdır, ama `fast`, `low`, `medium` ve `high` çaba seviyeleri atıf talimatlarını varsayılan olarak içerir ([geçiş rehberi](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)). `fast` seviyesinin talimatları, arama yapılmadıysa atıf koyulmamasını söyler ([çaba seviyeleri](https://docs.perplexity.ai/docs/agent-api/effort)).

**`[1]` en üstteki arama sonucu mudur?**
Belgeler `[n]` işaretinin `id` değeri `n` olan sonuca karşılık geldiğini söyler. `id` 1'in en iyi sonuç olduğunu söylemez.

**Sitemin atıf alması için ödeme yapabilir ya da başvurabilir miyim?**
Belgeler böyle bir seçenek anlatmıyor. Listelenen denetimler API'yi çağıran geliştiriciye aittir.

**Atıf almanın yolu hala Sonar mı?**
Sonar Chat Completions desteği 27 Eylül 2026'da sona erdi ve belgeler tüm yeni projeler için Agent API'yi öneriyor ([geçiş genel bakışı](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)).

## Kaynaklar

- [Perplexity API Platform genel bakış](https://docs.perplexity.ai/docs/getting-started/overview)
- [Web Search (Agent API)](https://docs.perplexity.ai/docs/agent-api/tools/web-search)
- [Search API genel bakış](https://docs.perplexity.ai/docs/search/overview)
- [Arama alan adı filtresi](https://docs.perplexity.ai/docs/search/filters/domain-filter)
- [Arama tarih ve zaman filtreleri](https://docs.perplexity.ai/docs/search/filters/date-time-filters)
- [Arama dil filtresi](https://docs.perplexity.ai/docs/search/filters/language-filter)
- [Sonar'dan Agent API'ye geçiş](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)
- [Sonar'dan nasıl geçilir](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to)
- [Çaba seviyeleri](https://docs.perplexity.ai/docs/agent-api/effort)
- [Sonar hızlı başlangıç (eski)](https://docs.perplexity.ai/docs/legacy/sonar/quickstart)