Dokümanlar / Uç Noktalar

Anahtar Kelime Araması

POST /api/v1/search/keyword

Bu sayfada

Anahtar Kelime Araması
İstek gövdesi
Yanıt alanları
Ne zaman semantiğe geçmeli
Önbellek

Anahtar Kelime Araması

Belge başlığı ve çıkarılmış metin üzerinde SQL tabanlı serbest metin araması yapar. Sunucu LIKE '%query%' benzeri bir filtre uygular — Türkçe kök eki farkındalığı yoktur. Bu yüzden "bankacılık" aramak "banka" kelimesini içeren belgeleri döndürmez.

İ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.

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 /search/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.

Parametreler

İsim	Konum	Tip	Zorunlu	Açıklama
`query`	Body	`string`	Evet	1-500 karakter serbest metin.
`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.

{
  "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": "..."
    }
  ]
}