Массовое создание коротких ссылок из CSV
Когда нужно 20, 200 или 2 000 ссылок — на каждый товар в каталоге, каждый стол в ресторане, каждого промоутера или каждую пачку листовок, — создавать их по одной долго, и легко ошибиться. В snap.kz для этого есть два способа: загрузить таблицу CSV на тарифе Бизнес или создать ссылки небольшим скриптом через API на тарифе Про.
Ниже — когда нужно много ссылок сразу, как подготовить таблицу в Excel или Google Таблицах, чтобы она загрузилась без ошибок, пример скрипта и как потом получить QR-коды пачкой.
Когда нужно много ссылок сразу
- Каталог и этикетки. QR-код на каждом товаре ведёт на его страницу: состав, размеры, инструкция. Подробнее — в гайде про QR-код на упаковке.
- Сеть кафе или филиалы. Отдельный QR-код на каждый стол или филиал — видно, где сканируют чаще.
- SMM-агентство. Ссылки для каждого клиента, поста и канала, чтобы потом показать отчёт по переходам.
- Ивенты. Своя ссылка на регистрацию для каждого спикера и партнёра — видно, кто сколько людей привёл.
- Промоутеры и продавцы. Личная ссылка или QR у каждого — переходы считаются по людям.
- Типографии. Партия визиток или листовок, где у каждого макета свой код.
Два способа
| Загрузка CSV | Скрипт через API | |
|---|---|---|
| Тариф | Бизнес | Про и Бизнес |
| Нужен программист | нет | немного — или ИИ-агент |
| Сколько ссылок на аккаунте | до 10 000 | Про — до 1 000, Бизнес — до 10 000 |
| Новых в сутки | до 3 000 | Про — до 300, Бизнес — до 3 000 |
| Скорость | одна загрузка файла | Про — до 60 запросов в минуту, Бизнес — до 300 |
Если ссылок больше сотни и вы не пишете код — удобнее Бизнес с загрузкой файла. Если ссылок десятки или вы и так работаете с API — хватит Про и короткого скрипта.
Подготовьте таблицу
Что должно быть в таблице
Минимум — адрес назначения в каждой строке. Обычно добавляют ещё свой адрес, название, чтобы потом находить ссылку в списке, и теги для группировки. Например:
| Адрес назначения | Свой адрес | Название | Теги |
|---|---|---|---|
https://alma-shop.kz/p/101 | alma-101 | Платье, артикул 101 | осень, этикетки |
https://alma-shop.kz/p/102 | alma-102 | Пальто, артикул 102 | осень, этикетки |
https://alma-shop.kz/p/103 | Шарф, артикул 103 | этикетки |
Это пример, а не формат файла. Точный порядок и названия столбцов — в шаблоне на странице массового создания в кабинете. Скачайте шаблон и заполните его, а не собирайте таблицу с нуля.
Если свой адрес не нужен, оставьте ячейку пустой — ссылка получит случайный код. Правила для своих адресов — латиница в нижнем регистре, цифры, дефис и подчёркивание, от 3 до 50 символов. Как придумать схему адресов для сотни ссылок — в гайде про свой адрес короткой ссылки.
Как сохранить CSV в Excel
Выберите «Файл» → «Сохранить как» → тип «CSV UTF-8 (разделитель — запятая)». Обычный тип «CSV» в русской версии Excel часто сохраняет файл в старой кодировке и с точкой с запятой вместо запятой. Тогда кириллица в названиях превращается в нечитаемые символы, а столбцы съезжают.
Как сохранить CSV в Google Таблицах
«Файл» → «Скачать» → «CSV». Google Таблицы всегда сохраняют CSV в UTF-8 с запятой, этот вариант надёжнее всего.
Проверьте перед загрузкой
- Каждый адрес начинается с
https://илиhttp://. Откройте несколько ссылок из таблицы — они должны работать. - Первая строка — заголовки, дальше — данные. Без пустых строк, объединённых ячеек и итогов внизу.
- Свои адреса не повторяются. Выделите столбец и включите «Условное форматирование» → «Повторяющиеся значения». Адрес один на весь сервис, поэтому популярные слова могут быть заняты — добавляйте бренд.
- Запятые внутри названий не страшны. Excel и Google Таблицы сами возьмут такие значения в кавычки. Не добавляйте кавычки вручную.
- Длина адреса — до 2 000 символов. Обычно это не проблема, но очень длинные ссылки с параметрами стоит проверить.
- Никаких ссылок на другие сокращатели. Сокращайте исходный адрес: цепочки сокращателей уходят на ручную проверку.
UTM-метки для всех ссылок сразу
Метки можно добавить формулой прямо в таблице. Если исходный адрес в столбце A:
=A2&ЕСЛИ(ЕЧИСЛО(НАЙТИ("?";A2));"&";"?")&"utm_source=label&utm_medium=print&utm_campaign=autumn"Формула ставит ?, если параметров в адресе ещё нет, и &, если уже есть. Протяните её вниз, затем скопируйте столбец и вставьте как значения. Что писать в каждой метке — в гайде про UTM-метки.
Загрузка CSV на тарифе Бизнес
- Откройте в кабинете страницу массового создания ссылок и скачайте шаблон.
- Перенесите в шаблон свои данные и сохраните его как CSV UTF-8.
- Загрузите файл и проверьте результат: все ли строки превратились в ссылки.
- Если какие-то строки не прошли — например, свой адрес уже занят или адрес назначения не начинается с
https://, — исправьте их и загрузите ещё раз только эти строки. - Выгрузите готовые ссылки в CSV и отдайте таблицу дизайнеру, типографии или коллегам.
Ссылки, похожие на страницы банков, госуслуг или маркетплейсов, проверяются вручную — даже если они пришли из файла. Запрещённый контент блокируется, список — в правилах.
Через API на тарифе Про
На тарифе Про загрузки файла нет, но те же ссылки можно создать скриптом. API-ключ берут в кабинете, он показывается один раз — сохраните его в переменной окружения. Все методы — в документации API.
Пример на Node.js 18+: читает links.csv с тремя столбцами — адрес, свой адрес, название, — создаёт ссылки и сохраняет результат в result.csv. Это пример для простой таблицы, где внутри значений нет запятых.
import { readFileSync, writeFileSync } from "node:fs";
const KEY = process.env.SNAP_API_KEY;
const rows = readFileSync("links.csv", "utf8").trim().split(/\r?\n/).slice(1).map((l) => l.split(","));
const out = ["url,short_url,qr_url"];
for (const [url, alias, title] of rows) {
const res = await fetch("https://snap.kz/api/v1/links", {
method: "POST",
headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ url, alias: alias || undefined, title, tags: ["этикетки"] }),
});
const data = await res.json();
if (res.status === 201) out.push([url, data.short_url, data.qr_url].join(","));
else console.error(url, res.status, data.error?.code, data.error?.message);
await new Promise((r) => setTimeout(r, 1100)); // на Про — до 60 запросов в минуту
}
writeFileSync("result.csv", out.join("\n"));То же на Python с библиотекой requests:
import csv, os, time, requests
KEY = os.environ["SNAP_API_KEY"]
with open("links.csv", encoding="utf-8") as f, open("result.csv", "w", encoding="utf-8", newline="") as out:
w = csv.writer(out)
w.writerow(["url", "short_url", "qr_url"])
for row in csv.DictReader(f): # столбцы: url, alias, title
body = {"url": row["url"], "title": row["title"]}
if row.get("alias"):
body["alias"] = row["alias"]
r = requests.post("https://snap.kz/api/v1/links", json=body,
headers={"Authorization": f"Bearer {KEY}"})
if r.status_code == 201:
d = r.json()
w.writerow([row["url"], d["short_url"], d["qr_url"]])
else:
print(row["url"], r.status_code, r.json().get("error"))
time.sleep(1.1)Что значат ответы с ошибкой:
| Код | Что случилось | Что делать |
|---|---|---|
| 409 | свой адрес уже занят | выбрать другой адрес для этой строки |
| 400 или 422 | неверные данные в строке | посмотреть error.message и исправить строку |
| 402 | тариф не позволяет | проверить тариф и лимит ссылок |
| 429 | слишком много запросов | подождать и повторить, увеличить паузу |
Скрипт может написать и ИИ-агент — или он создаст ссылки сам через MCP-сервер, без кода. Подробнее — в гайдах API для сокращения ссылок и ссылки и QR из ИИ-агента.
QR-коды пачкой
У каждой созданной ссылки есть свой QR-код. Через API его можно скачать в SVG — векторном формате, который нужен типографии:
curl -H "Authorization: Bearer $SNAP_API_KEY" \
"https://snap.kz/api/v1/links/$LINK_ID/qr?format=svg" -o alma-101.svgНазовите файлы по своему адресу или артикулу и сложите в одну папку — так дизайнер не перепутает, какой код на какую этикетку. Перед тиражом:
- проверьте размер: для этикетки — от 2 × 2 см, подробнее — в гайде как напечатать QR-код;
- отсканируйте несколько кодов с пробного оттиска, а не с экрана;
- сверьте выборочно, что код ведёт на нужный товар.
Короткие ссылки делают QR-коды проще: https://snap.kz/Ab3dEf?qr помещается в QR-код версии 2, а длинный адрес товара с метками может потребовать версию 8 с модулями почти вдвое мельче. На маленькой этикетке это разница между кодом, который читается, и кодом, который нет.
После создания
- Теги (на тарифе Про и выше) помогают смотреть ссылки группой: «этикетки», «осень-2026», «клиент Алма».
- Выгрузка в CSV (на тарифе Про и выше) — чтобы собрать отчёт в Excel. Как собрать отчёт клиенту — в гайде про отчёт для SMM.
- Смена назначения — если товар переехал на другую страницу, поменяйте адрес назначения у его ссылки, и этикетку перепечатывать не придётся.
- Ссылки не отключаются за неоплату. Если тариф закончится, все созданные ссылки продолжат вести туда же, куда вели. Новые сверх лимита бесплатного тарифа создать будет нельзя, пока не продлите.
Частые вопросы
Можно ли массово создать ссылки на бесплатном тарифе?
Нет. Загрузка CSV есть на тарифе Бизнес, API — на Про и Бизнес. На бесплатном тарифе ссылки создаются по одной: до 30 на аккаунте и до 10 новых в сутки.
Какой нужен формат файла?
CSV в кодировке UTF-8. В Excel выбирайте тип «CSV UTF-8», в Google Таблицах — «Скачать» → «CSV». Точный набор столбцов — в шаблоне на странице массового создания в кабинете.
Сколько ссылок можно создать за раз?
На тарифе Бизнес — до 1 000 строк за одну загрузку, до 3 000 новых ссылок в сутки и до 10 000 ссылок на аккаунте. На тарифе Про через API — до 300 в сутки и до 1 000 всего. Цены — на странице тарифов.
Можно ли сразу получить QR-коды для всех ссылок?
У каждой ссылки есть QR-код в PNG и SVG. Пачкой их удобно скачать через API: GET /api/v1/links/{id}/qr?format=svg для каждой ссылки из результата.
Что будет, если в таблице есть ошибка?
Ссылка из строки с ошибкой не создастся. Чаще всего это занятый свой адрес или адрес назначения без https://. Исправьте такие строки и загрузите их ещё раз.
Можно ли добавить UTM-метки всем ссылкам сразу?
Да. Допишите метки к адресам назначения формулой в таблице, как показано выше, или передавайте поле utm при создании ссылки через API.
Сделайте короткую ссылку с QR-кодом
Бесплатно — до 30 ссылок с QR-кодами и статистикой переходов. Ссылки не отключаются за неоплату, сервер — в Казахстане.