Базовый URL и аутентификация
Все запросы отправляются на адрес:Authorization каждого запроса:
401.
Создайте токен в приложении Gologin: API & MCP > API > Новый токен, либо в разделе API в блоке Connected accounts в AI Assistant. Токен можно создать на платном тарифе при включённой двухфакторной аутентификации в Gologin.
По умолчанию отправка выполняется в режиме пробного запуска
Приглашения, сообщения, комментарии и ответы отправляются, только если вы передаёте"send": true. Без этого параметра запрос выполняется как пробный запуск (dry run): он проверяет цель и сообщает, что произойдёт, то есть кто получатель, возможно ли приглашение и существует ли уже переписка, но ничего не отправляет. Сначала сделайте пробный запуск, затем повторите запрос с "send": true.
Для публикации постов, реакций и принятия приглашений используются свои параметры: publish, react и accept.
Подключение аккаунта
- Узнайте ID рабочего пространства: запрос
GET https://api.gologin.com/workspacesс тем же токеном вернёт ваши рабочие пространства и ихid. - Создайте аккаунт:
- Для входа передайте один из вариантов:
credentials(loginиpassword),cookiesилиbrowserProfileId— профиль Gologin, в котором уже выполнен вход в LinkedIn. - Для IP-адреса передайте
proxyCountry(коды можно получить черезGET /available-countries) или собственныйproxy(host,portи, при необходимости,protocol,username,password). Привязанный профиль Gologin использует свой прокси. - Чтобы импортировать существующие переписки, добавьте
"importHistory": true.
- Пока идёт настройка, аккаунт возвращается со статусом
pending. ПроверяйтеGET /accounts/{id}, покаstatusне изменится:
Каждое ожидание длится до 10 минут. Если код не отправлен или вход не подтверждён, аккаунт получает статус
auth_failed.
Поиск людей и отправка приглашения
- Поиск.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthвозвращаетprofile_urlиprofile_idдля каждого человека. Вместоqueryможно передатьurl— ссылку на поиск LinkedIn с фильтрами. - Проверка профиля.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLпоказываетis_connected,is_pendingиis_available_to_connect. - Приглашение. Сначала сделайте пробный запуск:
connectable_dry_run означает, что приглашение будет отправлено. Ответ not_connectable объясняет причину: already_connected, invite_pending или connect_unavailable. Повторите запрос с "send": true. Ответ sent_verified означает, что LinkedIn создал приглашение.
Отправка сообщения
POST /linkedin/messages/send принимает accountId, message и один из параметров:
profileUrl— чтобы написать человеку. Переписка с ним будет найдена или открыта, если её ещё нет; в ответе будетexisting_conversationилиnew_conversation. Если связаться с человеком можно только через платный InMail, вы получитеnot_messageableсpaid_inmail_required. Платный InMail никогда не тратится без вашего ведома.conversationId— чтобы продолжить переписку:conversation_idиз/linkedin/inbox, ID диалога вида2-…или URL диалога.
sent_verified вместе с message_id и conversation_id.
Чтение переписок
GET /linkedin/inbox?accountId=ACCOUNT_IDвозвращает список переписок аккаунта, сначала самые новые.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDвозвращает сообщения, сначала самые старые. Параметрlimitоставляет только самые последние.GET /workspaces/{workspaceId}/conversationsвозвращает переписки всех аккаунтов рабочего пространства, аGET /workspaces/{workspaceId}/inbox/unread— количество непрочитанных.
Получение новых сообщений через вебхук
{ accountId, workspaceId, event }. При ошибках доставка повторяется, и одно и то же событие может прийти дважды, поэтому убирайте дубликаты по event.id. Чтобы удалить вебхук, отправьте {"url": null}. Localhost и внутренние адреса не принимаются.
Лимиты
Действия через API учитываются в тех же лимитах, что и действия в приложении.GET /accounts/{id}/limitsвозвращает этап аккаунта и все лимиты: рекомендуемое значение, ваше собственное значение, применяемое значение, сколько уже использовано, иresetsAt— момент, когда в окне появится место ещё для одного действия.PUT /accounts/{id}/limitsменяетstageили ваши собственные значения вcustomLimits. Значениеnullудаляет ваше собственное значение.DELETE /accounts/{id}/limits/customсбрасывает все лимиты до рекомендуемых.GET /workspaces/{workspaceId}/accounts-usageпоказывает, сколько аккаунтов можно подключить в вашем рабочем пространстве и сколько мест занято.
Ошибки, о которых полезно знать
Прогрев перед серией запросов
Сессия, которая долго не используется, устаревает, и первый вызов после этого занимает несколько секунд. ВызывайтеPOST /accounts/{id}/warmup перед серией вызовов или сразу после повторного входа. Аккаунт должен иметь статус active.