C# SDK engine

Google Jobs

Вакансии из Google Jobs: результаты поиска, фильтры, подсказки/chips, highlights, apply options и пагинация по next_page_token.

engine: google_jobs constant: XylopSearchEngines.GoogleJobs GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleJobs,
    new Dictionary<string, string?>
    {
        ["q"] = "barista new york",
        ["location"] = "New York, United States",
        ["uule"] = "w+CAIQICINVW5pdGVkIFN0YXRlcw",
        ["google_domain"] = "google.com",
        ["gl"] = "us",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_jobs
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_jobs`	Движок Google Jobs.
`q`	string	Да	barista new york	Поисковая фраза для вакансий.
`location`	string	Нет	New York, United States	Город или регион поиска. Нельзя использовать вместе с uule.
`uule`	string	Нет	w+CAIQICINVW5pdGVkIFN0YXRlcw	Google encoded location. Нельзя использовать вместе с location.
`google_domain`	string	Нет	`google.com`	Региональный домен Google.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`lrad`	string	Нет	10	Радиус поиска в километрах.
`ltype`	string	Нет	1	Фильтр work from home.
`uds`	string	Нет	filter token	Токен фильтра из filters[].uds.
`next_page_token`	string	Нет	pagination.next_page_token	Токен следующей страницы.

Выходные параметры

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`filters`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`jobs_results`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`pagination`	object	пример ответа	Данные пагинации или токены для перехода к следующей странице.

JSON

Пример ответа

{
  "search_metadata": {
    "status": "Success",
    "google_jobs_url": "https://www.google.com/search?q=barista+new+york&udm=8"
  },
  "search_parameters": {
    "engine": "google_jobs",
    "q": "barista new york",
    "google_domain": "google.com"
  },
  "filters": [
    {
      "name": "Job type",
      "options": [
        {
          "name": "Full time",
          "uds": "ADvngMh...",
          "q": "barista new york full time"
        }
      ]
    }
  ],
  "jobs_results": [
    {
      "title": "Barista",
      "company_name": "Caffe Vita",
      "location": "New York, NY",
      "via": "ZipRecruiter",
      "extensions": [
        "25 days ago",
        "Full-time"
      ],
      "detected_extensions": {
        "posted_at": "25 days ago",
        "schedule_type": "Full-time"
      },
      "description": "Caffe Vita baristas are passionate about coffee and customer service.",
      "job_highlights": [
        {
          "title": "Benefits",
          "items": [
            "$16.50/hr + Tips"
          ]
        }
      ],
      "apply_options": [
        {
          "title": "ZipRecruiter",
          "link": "https://www.ziprecruiter.com/..."
        }
      ],
      "job_id": "eyJqb2JfdGl0bGUiOiJCYXJpc3RhIn0="
    }
  ],
  "pagination": {
    "next_page_token": "eyJ..."
  }
}