КурьерHUB

Все сервисы доставки, куда КурьерHUB подключает курьеров в России: что можно возить, на чём работать, как часто платят, свободный ли график, балл оценки редакции и в скольких городах сервис публикует ставку. Начните отсюда, чтобы узнать slug сервиса для остальных тулов. Самих ставок здесь нет — они зависят от города, для них есть get_city_rates и calculate_income.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Полная карточка одного сервиса: условия старта (минимальный возраст, гражданство, формы оформления, медкнижка, минимальная смена), что сервис даёт сам (транспорт, экипировка, страховка), выплаты и график, оценка редакции по шести критериям с вердиктом, контакты поддержки курьера, тарифы и обещанная сервисом сумма. У каждого блока — ссылка на первоисточник и дата, когда мы его сверяли.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "slug или название сервиса"
    }
  },
  "required": [
    "service"
  ],
  "additionalProperties": false
}

Лента сервисов в конкретном городе с теми же фильтрами и сортировкой, что на главной странице сайта. Возвращает строки «сервис × способ доставки × тариф» со ставкой ₽/час, доходом за смену и за месяц при заданном графике. Считается теми же функциями, что и витрина, — числа совпадают. Сервисы, которые в городе работают, но сумму не публикуют, стоят внизу с пометкой.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Ключ города (msk) или название. По умолчанию — город, выбранный человеком на сайте."
    },
    "transport": {
      "type": "string",
      "enum": [
        "foot",
        "bike",
        "car"
      ],
      "description": "bike покрывает и электровелосипед"
    },
    "payout": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "instant",
          "daily",
          "several_week",
          "weekly"
        ]
      },
      "description": "Периодичность выплат: любое из перечисленных"
    },
    "schedule": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "free",
          "shifts_self",
          "shifts_assigned",
          "mixed"
        ]
      }
    },
    "perks": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "vehicle",
          "gear",
          "insurance",
          "medbookNotNeeded",
          "shortShift"
        ]
      },
      "description": "Что сервис даёт на старте. Выбранное должно выполняться одновременно."
    },
    "employment": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "self_employed",
          "ip",
          "gph",
          "park",
          "staff"
        ]
      }
    },
    "citizenship": {
      "type": "string",
      "enum": [
        "rf",
        "eaeu",
        "any"
      ]
    },
    "maxMinAge": {
      "type": "integer",
      "enum": [
        14,
        16,
        18
      ],
      "description": "Возраст кандидата: показать сервисы, берущие с этого возраста"
    },
    "services": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ограничить выборку слагами сервисов"
    },
    "sort": {
      "type": "string",
      "enum": [
        "rate",
        "score"
      ],
      "description": "rate — по доходу за месяц (по умолчанию); тариф, который при заданном графике не платят (см. tariffHint), идёт в конец. score — по оценке редакции"
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    }
  },
  "additionalProperties": false
}

Сравнение двух-трёх сервисов в одном городе построчно: ставка ₽/час, доход за смену и за месяц при заданном графике, выплаты, график, оценка редакции, транспорт и экипировка от сервиса, страховка, медкнижка, минимальный возраст, гражданство. Тот же набор строк, что в таблице сравнения на сайте. Больше трёх сервисов не сравниваем — столько колонок не читается.

{
  "type": "object",
  "properties": {
    "services": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 3,
      "description": "slug'и сервисов"
    },
    "city": {
      "type": "string"
    },
    "transport": {
      "type": "string",
      "enum": [
        "foot",
        "bike",
        "car"
      ]
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    }
  },
  "required": [
    "services"
  ],
  "additionalProperties": false
}

Считает доход курьера по формуле калькулятора сайта: ставка ₽/час × часы в день × дней в неделю × недель в месяце, где множитель месяца берётся у самого сервиса, если он его публикует. У сервиса без ставки, но со своими наблюдениями по дням недели (Яндекс Доставка), считается его формулой — суммой выбранных дней. Возвращает месяц, день и на сколько процентов это выше медианной зарплаты по городу. Округление до тысячи — как на сайте.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "transport": {
      "type": "string",
      "enum": [
        "foot",
        "bike",
        "ebike",
        "scooter",
        "car"
      ]
    },
    "tariff": {
      "type": "string",
      "description": "id тарифа, если у сервиса ставка делится по режимам работы"
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "weekdays": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "mon",
          "tue",
          "wed",
          "thu",
          "fri",
          "sat",
          "sun"
        ]
      },
      "description": "Только для сервиса с доходом по дням недели: какие именно дни. По умолчанию — дни самого сервиса."
    }
  },
  "required": [
    "service",
    "city"
  ],
  "additionalProperties": false
}

Подбирает сервис по трём ответам квиза с сайта: на чём возить (пешком, велосипед, автомобиль), сколько времени готовы работать (полный день, подработка, как получится) и что важнее (максимальный доход, частые выплаты, простой старт). Возвращает главную рекомендацию, альтернативу и правило, по которому они выбраны. Если на выбранном транспорте в городе никто не набирает, честно говорит об этом и показывает лучших по оценке редакции.

{
  "type": "object",
  "properties": {
    "transport": {
      "type": "string",
      "enum": [
        "foot",
        "bike",
        "car"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "income",
        "payout",
        "easyStart"
      ]
    },
    "time": {
      "type": "string",
      "enum": [
        "fulltime",
        "parttime",
        "flexible"
      ]
    },
    "city": {
      "type": "string",
      "description": "Не задан — подбор по стране целиком"
    }
  },
  "required": [
    "transport",
    "priority"
  ],
  "additionalProperties": false
}

Ставки всех сервисов в городе по каждому способу доставки плюс индекс ставок курьера: медиана публичных велоставок города, зона шкалы, отклонение от России и дата сверки. Это индекс СТАВОК, а не дохода. Своего индекса у большинства городов нет — там меньше четырёх сервисов с велоставкой, и медиана по двум цифрам ничего не значит; тогда возвращается индекс по стране, и это написано в ответе.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "transport": {
      "type": "string",
      "enum": [
        "foot",
        "bike",
        "ebike",
        "scooter",
        "car"
      ]
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false
}

Города России, по которым у нас есть ставки: поиск по названию, сколько сервисов публикует ставку в городе, максимальная ставка ₽/час и есть ли на сайте городская страница. Если задан сервис — вернёт покрытие именно его: где он публикует ставку и где работает без публичной ставки.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Часть названия города"
    },
    "service": {
      "type": "string",
      "description": "Покрытие одного сервиса"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

Поиск по статьям блога тем же алгоритмом, что и строка поиска на сайте: слова приводятся к основе, поэтому «велосипеду» находит «велосипед»; синонимы и опечатки подхватываются следующими проходами. Возвращает заголовок, описание, дату, тему и две ссылки — на страницу статьи и на её markdown-версию для чтения без вёрстки. Полного текста здесь нет: за ним идите по markdownUrl.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Справочник терминов сервисов доставки: что такое слот, коэффициент спроса, КИС АРТ, приоритет курьера. Ищет по названию и синонимам, возвращает определение слово в слово как на сайте, первоисточники и ссылку. Термин, разобранный у нас отдельной статьёй, вернёт ссылку на статью — своей страницы у него нет.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Ссылка, по которой курьер откликается в выбранный сервис. Возвращает ссылку на отклик, флаг partnerLink (платит ли сервис вознаграждение КурьерHUB за этого курьера), готовый текст раскрытия и адрес страницы сервиса на сайте. Вызывайте, когда человек уже выбрал сервис и хочет откликнуться. Ссылку передайте человеку вместе с раскрытием (поле disclosure) — сам по ней не переходите и не открывайте её для проверки: вознаграждение платится за живого курьера, а машинные переходы искажают статистику сервиса. Анкету человек заполняет на сайте сервиса, КурьерHUB заявки не принимает.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "slug сервиса из list_services, например samokat"
    }
  },
  "required": [
    "service"
  ],
  "additionalProperties": false
}