Dokümanlar / Uç Noktalar

Anahtar Kelime Araması

POST /api/v1/search/keyword

Bu sayfada

Anahtar Kelime Araması
İstek gövdesi
Yürürlük süzgeci
Yanıt alanları
Ne zaman semantiğe geçmeli
Önbellek

Anahtar Kelime Araması

Belge başlığı ve AI özeti üzerinde SQL tabanlı serbest metin araması yapar. Sunucu LIKE '%query%' benzeri bir alt-dize filtresi uygular: büyük/küçük harfe duyarlıdır ve Türkçe kök eki farkındalığı yoktur. Bu yüzden "bankacılık" aramak "banka" kelimesini içeren belgeleri döndürmez, "Kripto" ile "kripto" da aynı sonucu vermez.

Belgenin çıkarılmış tam metni bu aramaya dâhil değildir — yalnızca gövdede geçen bir terim bu uçtan asla bulunamaz. Gövde metninde arama için /library/semantic (anlamlı arama) kullanın.

İstek gövdesi

query — zorunlu, 1-500 karakter. Boş değer 400 VALIDATION_ERROR döner.
maxResults — 1-100 arası; varsayılan 10. Sayfalama yoktur; daha fazla istiyorsanız filtreleri daraltın.
sourceId — opsiyonel kaynak filtresi.
startDate / endDate — opsiyonel yayım tarihi penceresi.

Yürürlük süzgeci

Bu uç nokta yalnızca yürürlükteki mevzuatı arar; mülga belgeler sonuçlara hiçbir koşulda girmez ve bunu kapatan bir parametre yoktur ("Değişmiş", yani değiştirilmiş ama hâlâ yürürlükteki belgeler dâhildir). Aradığınız belge mülga ise sonuç boş döner — bu bir hata değildir. Mülga mevzuatta arama yapmanız gerekiyorsa GET /library?search=...&legalStatus=all (veya legalStatus=mulga) ya da GET /documents?filter=...&legalStatus=all kullanın.

Yanıt alanları

matchedSnippet — anahtar kelime aramasında her zaman boş string döner; snippet yalnızca semantik aramada anlamlıdır.
score — anahtar kelime aramasında her zaman 1.0 döner (sıralama skorlaması yoktur).

Ne zaman semantiğe geçmeli

Eş anlamlı kelimeler veya kavram bazlı arama gerekiyorsa /library/semantic kullanın. Anahtar kelime araması yalnızca kesin eşleşmeler (exact substring) için uygundur ve semantikten ~10× daha ucuzdur.

Önbellek

Aynı (query, maxResults, sourceId, startDate, endDate) beşlisi 5 dakika boyunca önbelleklenir — tekrar sorgu atarsanız anında yanıt alırsınız.

Aynı mevzuatın ikinci resmî nüshası (ikiz) listelerde ve sayımlarda yer almaz; GET /library/{id} detay ucu canonicalDocumentId ile sahibine işaret eder.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`query`	Body	`string`	Evet	1-500 karakter serbest metin. Belge başlığı ve AI özetinde alt-dize olarak aranır (büyük/küçük harfe duyarlı); çıkarılmış tam metin bu aramaya dâhil değildir.
`maxResults`	Body	`integer`	Hayır	1-100 arası; varsayılan 10.
`sourceId`	Body	`uuid?`	Hayır	Kaynakla sınırlandırma.
`startDate`	Body	`date-time?`	Hayır	Yayım alt sınırı.
`endDate`	Body	`date-time?`	Hayır	Yayım üst sınırı.

Yanıtlar

200 — Eşleşen belgeler. Yalnızca yürürlükteki mevzuat döner — mülga belgeler hiçbir koşulda sonuçlara girmez ve bunu kapatan bir parametre yoktur.

{
  "success": true,
  "data": [
    {
      "documentId": "...",
      "title": "...",
      "sourceName": "Resmi Gazete",
      "publishedDate": "2026-03-28T00:00:00Z",
      "score": 1.0,
      "matchedSnippet": "",
      "summary": "..."
    }
  ]
}

400 — Query alanı boş.

⚠️ Sunucudan sunucuya — API anahtarınızı tarayıcıda paylaşmayın. Neden?

curl -X POST \
  "https://api.regvion.com/api/v1/search/keyword" \
  -H "X-API-Key: rgv_live_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "kripto varlık",
  "maxResults": 10
}'

const url = 'https://api.regvion.com/api/v1/search/keyword';
const headers = {
  'X-API-Key': 'rgv_live_REPLACE_WITH_YOUR_KEY'
  , 'Content-Type': 'application/json'
};

const response = await fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify({
  "query": "kripto varlık",
  "maxResults": 10
})
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const body = await response.json();
console.log(body.data);
console.log('Request ID:', body.meta.requestId);

import requests

url = "https://api.regvion.com/api/v1/search/keyword"
headers = {"X-API-Key": "rgv_live_REPLACE_WITH_YOUR_KEY"}
payload = {
  "query": "kripto varlık",
  "maxResults": 10
}
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
body = response.json()
print(body["data"])
print("Request ID:", body["meta"]["requestId"])

using System.Net.Http;
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY");

var payload = new StringContent("""{
  "query": "kripto varlık",
  "maxResults": 10
}""", Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.regvion.com/api/v1/search/keyword", payload);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(body.GetProperty("meta").GetProperty("requestId").GetString());

<?php
require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$options = [
    'headers' => [
        'X-API-Key' => 'rgv_live_REPLACE_WITH_YOUR_KEY',
    ],
    'json' => [
  "query" => "kripto varlık",
  "maxResults" => 10
],
];

$response = $client->request('POST', 'https://api.regvion.com/api/v1/search/keyword', $options);
$body = json_decode($response->getBody(), true);
echo 'Request ID: ' . $body['meta']['requestId'];

import java.net.URI;
import java.net.http.*;
import java.net.http.HttpRequest.BodyPublishers;

HttpClient client = HttpClient.newHttpClient();

HttpRequest.Builder b = HttpRequest.newBuilder()
    .uri(URI.create("https://api.regvion.com/api/v1/search/keyword"))
    .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(BodyPublishers.ofString("{\n  \"query\": \"kripto varlık\",\n  \"maxResults\": 10\n}"));

HttpResponse<String> response = client.send(b.build(), HttpResponse.BodyHandlers.ofString());
System.out.println("Status: " + response.statusCode());
System.out.println(response.body());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body := bytes.NewReader([]byte("{\n  \"query\": \"kripto varlık\",\n  \"maxResults\": 10\n}"))
    req, _ := http.NewRequest("POST", "https://api.regvion.com/api/v1/search/keyword", body)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()

    var envelope struct {
        Data interface{} `json:"data"`
        Meta struct { RequestId string `json:"requestId"` } `json:"meta"`
    }
    json.NewDecoder(resp.Body).Decode(&envelope)
    fmt.Println("Request ID:", envelope.Meta.RequestId)
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.regvion.com/api/v1/search/keyword')
request = Net::HTTP::Post.new(uri)
request['X-API-Key'] = 'rgv_live_REPLACE_WITH_YOUR_KEY'
request['Content-Type'] = 'application/json'
request.body = '{\n  "query": "kripto varlık",\n  "maxResults": 10\n}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

body = JSON.parse(response.body)
puts "Request ID: #{body['meta']['requestId']}"

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val client = OkHttpClient()

val builder = Request.Builder()
    .url("https://api.regvion.com/api/v1/search/keyword")
    .addHeader("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
    .post("{\n  \"query\": \"kripto varlık\",\n  \"maxResults\": 10\n}".toRequestBody("application/json".toMediaType()))

client.newCall(builder.build()).execute().use { response ->
    println("Status: ${'$'}{response.code}")
    println(response.body?.string())
}

import Foundation

var request = URLRequest(url: URL(string: "https://api.regvion.com/api/v1/search/keyword")!)
request.httpMethod = "POST"
request.setValue("rgv_live_REPLACE_WITH_YOUR_KEY", forHTTPHeaderField: "X-API-Key")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = "{\n  \"query\": \"kripto varlık\",\n  \"maxResults\": 10\n}".data(using: .utf8)

let (data, response) = try await URLSession.shared.data(for: request)
if let http = response as? HTTPURLResponse { print("Status: \(http.statusCode)") }
print(String(data: data, encoding: .utf8) ?? "")

use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let mut req = client.post("https://api.regvion.com/api/v1/search/keyword")
        .header("X-API-Key", "rgv_live_REPLACE_WITH_YOUR_KEY")
        .header("Content-Type", "application/json")
        .body("{\n  \"query\": \"kripto varlık\",\n  \"maxResults\": 10\n}")
        ;
    let res = req.send()?;
    println!("Status: {}", res.status());
    println!("{}", res.text()?);
    Ok(())
}

$headers = @{
    'X-API-Key' = 'rgv_live_REPLACE_WITH_YOUR_KEY'
}

$body = @'
{
  "query": "kripto varlık",
  "maxResults": 10
}
'@

$response = Invoke-RestMethod -Uri 'https://api.regvion.com/api/v1/search/keyword' -Method Post `
    -Headers $headers -Body $body -ContentType 'application/json'

$response.data
Write-Host "Request ID:" $response.meta.requestId

Yanıt (200)

{
  "success": true,
  "data": [
    {
      "documentId": "...",
      "title": "...",
      "sourceName": "Resmi Gazete",
      "publishedDate": "2026-03-28T00:00:00Z",
      "score": 1.0,
      "matchedSnippet": "",
      "summary": "..."
    }
  ]
}