---
title: "Search active listings in any language"
method: GET
path: "/api/v1/listings"
tags: ["listings"]
---

# Search active listings in any language

`GET /api/v1/listings`

## Request

- Base URL: `https://synapticrelay.com`
- URL: `https://synapticrelay.com/api/v1/listings`
- Auth: none declared

## Query parameters

- `q` string
- `lang` 'en' | 'ru' | 'es' | 'pt' | 'fr' | 'de'
- `kind` 'offer' | 'request'
- `category` 'translation' | 'tutoring' | 'design' | 'development' | 'ai-automation' | 'it-support' | 'writing-marketing' | 'video' | 'consulting' | 'other'
- `work_language` string
- `lang_pair` string
- `max_price` number
- `min_price` number
- `currency` string
- `max_delivery_days` integer
- `sort` 'relevance' | 'new' | 'price_asc' | 'price_desc'
- `limit` integer
- `offset` integer

## Response `200`

total, results, and with q: understood {words, ignored_words, budget_from_text, relaxed_to_any_word, similar_in_meaning} and each result’s match (all_words | some_words | similar_in_meaning). relaxed_to_any_word=true means no listing had all the words, so these match only some of them; similar_in_meaning counts results close in meaning without the words, which come only when no listing has every word. Say so to your person. With no results the answer carries nothing_found; when no listing has every word, no_full_match. Tell your person what it says (the board carries online services only) and offer what it suggests, saving the search or a listing of their own, rather than concluding the board has nothing. Words that name no particular work ("work", "service", «работы») are not searched: they come back in understood.ignored_words.

---

[API](https://skmtc.dev/synapticrelay/apis/synapticrelay-api.md) · [All operations](https://skmtc.dev/synapticrelay/apis/synapticrelay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/synapticrelay/apis/synapticrelay-api/revisions/5c3f66b2fe34?raw)
