Yapılan arama, arama için kullanılan motorla ilgili meta veriler ve arama sonuçlarıyla ilgili meta verileri döndürür. Küçük bir URL kalıpları grubu kullanır.
HTTP isteği
GET https://customsearch.googleapis.com/customsearch/v1/siterestrict
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler | |
|---|---|
| c2coff | 
 Basitleştirilmiş ve Geleneksel Çince Arama'yı etkinleştirir veya devre dışı bırakır. Bu parametrenin varsayılan değeri 0'dır (sıfır). Bu, özelliğin etkinleştirildiği anlamına gelir. Desteklenen değerler: 
 | 
| cr | 
 Arama sonuçlarını, belirli bir ülkeden gelen dokümanlarla kısıtlar. cr parametresi değerinde Boole operatörlerini kullanabilirsiniz. Google Arama, bir dokümanın ülkesini belirlemek için aşağıdakileri analiz eder: 
 Bu parametrenin geçerli değerlerinin listesi için Ülke Parametresi Değerleri sayfasına bakın. | 
| cx | 
 Bu istek için kullanılacak Programlanabilir Arama Motoru Kimliği. | 
| dateRestrict | 
 Sonuçları tarihe dayalı URL'lerle kısıtlar. Desteklenen değerler şunlardır: 
 | 
| exactTerms | 
 Arama sonuçlarındaki tüm dokümanların içermesi gereken bir kelime öbeğini tanımlar. | 
| excludeTerms | 
 Arama sonuçlarındaki hiçbir dokümanda görünmemesi gereken bir kelimeyi veya kelime öbeğini tanımlar. | 
| fileType | 
 Sonuçları, belirli bir uzantıya ait dosyalarla kısıtlar. Google tarafından dizine eklenebilen dosya türlerinin listesini Search Console Yardım Merkezi'nde bulabilirsiniz. | 
| filter | 
 Yinelenen içerik filtresini etkinleştirmeyi veya devre dışı bırakmayı kontrol eder. 
 Kabul edilebilir değerler şunlardır: 
 | 
| gl | 
 Son kullanıcının coğrafi konumu. 
 | 
| googlehost | 
 Kullanımdan kaldırıldı. Benzer bir efekt için  Aramayı gerçekleştirmek için kullanılacak yerel Google alan adı (ör. google.com, google.de veya google.fr). | 
| highRange | 
 Bir arama aralığının bitiş değerini belirtir. 
 | 
| hl | 
 Kullanıcı arayüzü dilini ayarlar. 
 | 
| hq | 
 Belirtilen sorgu terimlerini, mantıksal bir AND operatörüyle birleştirilmişmiş gibi sorguya ekler. | 
| imgColorType | 
 Siyah beyaz, gri tonlamalı, şeffaf veya renkli görseller döndürür. Kabul edilebilir değerler şunlardır: 
 | 
| imgDominantColor | 
 Belirli bir baskın rengin görsellerini döndürür. Kabul edilebilir değerler şunlardır: 
 | 
| imgSize | 
 Belirtilen boyuttaki görselleri döndürür. Kabul edilebilir değerler şunlardır: 
 | 
| imgType | 
 Belirli bir türdeki görselleri döndürür. Kabul edilebilir değerler şunlardır: 
 | 
| linkSite | 
 Tüm arama sonuçlarının belirli bir URL'ye bir bağlantı içermesi gerektiğini belirtir. | 
| lowRange | 
 Bir arama aralığının başlangıç değerini belirtir. Sorguya  | 
| lr | 
 Aramayı belirli bir dilde yazılmış dokümanlarla kısıtlar (ör.  Kabul edilebilir değerler şunlardır: 
 | 
| num | 
 Döndürülecek arama sonuçlarının sayısı. 
 | 
| orTerms | 
 Bir dokümanda kontrol edilecek ek arama terimleri sağlar. Burada, arama sonuçlarındaki her doküman ek arama terimlerinden en az birini içermelidir. | 
| q | 
 Sorgu | 
| relatedSite | 
 Kullanımdan kaldırıldı. | 
| rights | 
 Lisanslamaya dayalı filtreler. Desteklenen değerler şunları içerir:  | 
| safe | 
 Arama güvenlik seviyesi. Kabul edilebilir değerler şunlardır: 
 | 
| searchType | 
 Arama türünü belirtir:  Kabul edilebilir değerler şunlardır: 
 | 
| siteSearch | 
 Her zaman sonuçlara dahil edilmesi veya sonuçlardan hariç tutulması gereken belirli bir siteyi belirtir (aşağıdaki  | 
| siteSearchFilter | 
 
 Kabul edilebilir değerler şunlardır: 
 | 
| sort | 
 Sonuçlara uygulanacak sıralama ifadesi. Sıralama parametresi, sonuçların belirtilen ifadeye göre sıralanacağını (ör. tarihe göre sıralama) belirtir. Örnek: Sort=date. | 
| start | 
 Döndürülecek ilk sonucun dizini. Her sayfa için varsayılan sonuç sayısı 10'dur, dolayısıyla  | 
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Search öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
- https://www.googleapis.com/auth/cse
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.