Allmine API
Search

Birleşik arama (Kullanıcılar ve Yayınlar)

Kullanıcıları ve yayınları tek bir endpoint ile arayabilirsiniz. Kullanıcı araması için kullanıcı adı, isim veya soyisim alanlarında arama yapılır. Yayın araması için başlık, motivasyon yazısı veya yayıncı bilgilerine göre arama yapılır. Query parametresi boşsa rastgele sonuçlar döndürülür. Her iki arama sonucu ayrı ayrı döndürülür.

GET
/api/v1/search

Kullanıcıları ve yayınları tek bir endpoint ile arayabilirsiniz. Kullanıcı araması için kullanıcı adı, isim veya soyisim alanlarında arama yapılır. Yayın araması için başlık, motivasyon yazısı veya yayıncı bilgilerine göre arama yapılır. Query parametresi boşsa rastgele sonuçlar döndürülür. Her iki arama sonucu ayrı ayrı döndürülür.

Authorization

JWT-auth
AuthorizationBearer <token>

Paste the JWT access token without the Bearer prefix.

In: header

Query Parameters

q?string

Arama terimi (kullanıcı adı, isim, soyisim, yayın başlığı veya motivasyon yazısı). Boş bırakılırsa rastgele sonuçlar döndürülür.

page?number

Sayfa numarası (her iki arama için de geçerli)

Default1
Range1 <= value
limit?number

Sayfa başına öğe sayısı (her iki arama için de geçerli, maksimum 100)

Default10
Range1 <= value <= 100
expertise?string

Kullanıcı araması için expertise filtresi

Value in"musician" | "trainer" | "chef" | "photographer" | "designer" | "stylist" | "gamer" | "educator" | "coach" | "entertainer" | "developer" | "creator"
status?string

Yayın araması için yayın durumu filtresi

Value in"active" | "ended" | "scheduled" | "preparing" | "expired" | "cancelled_by_host" | "cancelled_by_guest"
interest?string

Yayın araması için ilgi alanı filtresi

Value in"music" | "sports" | "travel" | "cooking" | "reading" | "movies" | "gaming" | "photography" | "art" | "technology" | "fitness" | "nature" | "fashion" | "dancing" | "learning"

Header Parameters

X-Language?string

Uygulama içerisinde seçilen dil (varsayılan: en)

Value in"en" | "tr"
X-Timezone?string

Zaman dilimi (varsayılan: UTC)

Value in"UTC-12:00" | "UTC-11:00" | "UTC-10:00" | "UTC-09:30" | "UTC-09:00" | "UTC-07:00" | "UTC-06:00" | "UTC-05:00" | "UTC-04:00" | "UTC-03:30" | "UTC-03:00" | "UTC-02:00" | "UTC-01:00" | "UTC+00:00" | "UTC+01:00" | "UTC+02:00" | "UTC+03:00" | "UTC+03:30" | "UTC+04:00" | "UTC+04:30" | "UTC+05:00" | "UTC+05:30" | "UTC+05:45" | "UTC+06:00" | "UTC+06:30" | "UTC+07:00" | "UTC+08:00" | "UTC+08:45" | "UTC+09:00" | "UTC+09:30" | "UTC+10:00" | "UTC+10:30" | "UTC+11:00" | "UTC+12:00" | "UTC+12:45" | "UTC+13:00" | "UTC+14:00"
X-Platform?string

Platform (varsayılan: web)

Value in"web" | "mobile_ios" | "mobile_android" | "admin" | "api" | "unknown" | "all"
X-App-Version?string

Uygulama versiyonu (opsiyonel)

X-Device-ID?string

Cihaz kimliği (opsiyonel)

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/search"
{
  "isSuccess": false,
  "statusCode": 400,
  "data": null,
  "errors": [
    "Validation failed"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 401,
  "data": null,
  "errors": [
    "Authentication required"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}
{
  "isSuccess": false,
  "statusCode": 403,
  "data": null,
  "errors": [
    "Insufficient permissions"
  ],
  "timestamp": "2026-01-15T10:30:00.000Z"
}