linkedin/
search-posts

Находите проиндексированные Google публичные публикации LinkedIn по ключевому слову и необязательной относительной дате и получайте нормализованный контент, авторов, медиа, теги, метки времени и видимую вовлеченность.

LinkedIn Search Posts API

Поиск по ключевому слову
Относительная дата
Канонические публикации
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

LinkedIn Search Posts

LinkedIn Search Posts использует внешний метод поиска по индексу Google, чтобы найти публичные страницы по одному запросу с ключевым словом, а затем извлекает доступные записи публикаций. Результат — это ранжированная выборка на момент сбора, а не персонализированный встроенный поиск LinkedIn и не полный архив, поэтому ее не следует считать общим объемом обсуждений, охватом, тональностью или долей голоса.

Возможности LinkedIn Search Posts API

  • Поиск от ключевого словаИщите публично проиндексированные страницы LinkedIn по одному обязательному непустому запросу: теме, организации, продукту, человеку или фразе.
  • Необязательная относительная датаПередает провайдеру строку date_posted; в документации указаны значения last-hour, last-day, last-week, last-month и last-year.
  • Лимиты, кратные страницеЗадайте results_limit от 10 до 2 000 с шагом 10; по умолчанию 10, и допустимое значение не гарантирует соответствующего охвата у провайдера.
  • Канонические записи публикацийПолучайте стабильные поля контента, автора, метрик, медиа, хештегов, упоминаний, публикации и сбора.
  • Сбор с учетом курсораПереходит по курсорам провайдера, пока сбор не остановят запрошенный лимит, последняя или пустая страница, отсутствующий или повторившийся курсор.

Параметры LinkedIn Search Posts API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательное непустое ключевое слово или фраза для поиска публичных проиндексированных публикаций.
date_postedНеобязательныйНеобязательная непустая строка относительной даты, которая передается провайдеру. SocQ не проверяет самостоятельно значения из документации провайдера.
results_limitНеобязательныйНеобязательный целочисленный лимит результатов. По умолчанию 10, допускаются значения от 10 до 2 000, кратные размеру страницы провайдера в 10 записей.

Как использовать LinkedIn Search Posts API

Отправьте один запрос с ключевым словом, опрашивайте асинхронную задачу и изучите полученную выборку.

  1. Выберите один непустой query и при необходимости строку относительной даты провайдера.
  2. Отправьте query, date_posted и значение, кратное 10 записям, методом POST на /v1/linkedin/search-posts и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в конечный статус.
  4. После успешного завершения обработайте data.results.items и переходите по next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI agents","date_posted":"last-week","results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования LinkedIn Search Posts API

  • Поиск по теме: Находите публично проиндексированные публикации, в которых упоминается выбранная тема, продукт, организация, человек или фраза.
  • Анализ сообщений и форматов: Изучайте утверждения, хештеги, авторов, ссылки и форматы медиа в результатах, не считая выборку исчерпывающей.
  • Отбор авторов и URL: Определяйте публичных авторов и URL публикаций для ручной проработки или сбора данных по конкретному автору.
  • Передача к обсуждениям: Отбирайте релевантные URL из результатов и передавайте их в LinkedIn Post Comments, когда нужны записи публичных обсуждений.

Практические советы по LinkedIn Search Posts API

  • Используйте одинаковые запрос, строку даты, лимит результатов и расписание сбора, когда сравниваете выборки.
  • Считайте порядок из источника поисковым ранжированием, а не нейтральной оценкой популярности, свежести или релевантности.
  • Не считайте успешный пустой результат доказательством того, что подходящих публикаций LinkedIn не существует.
  • Проверяйте важный текст и медиа в исходной публикации: проиндексированные страницы могут быть устаревшими, обрезанными, удаленными или закрытыми.
  • Считайте отсутствующие значения вовлеченности неизвестными, а не нулевыми, и сохраняйте collected_at с каждым снимком.
  • Используйте company-posts или profile-posts, если нужный автор публикаций уже известен.

Помимо LinkedIn Search Posts API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.

  • LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
  • LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
  • LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
  • LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
  • LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.
  • LinkedIn Search People API — Находите публичные профили кандидатов по URL поиска людей в LinkedIn и получайте нормализованные данные личности, описание, изображения, местоположение, сайт, признаки аккаунта и доступные метрики.

Другие платформы

Объединяйте данные LinkedIn с публичными данными других поддерживаемых соцсетей.

LinkedIn Search Posts API — FAQ

LinkedIn Search Posts API — это программный интерфейс для поиска проиндексированных Google публичных публикаций LinkedIn по одному запросу с ключевым словом и необязательной строке относительной даты. Он возвращает нормализованный контент публикаций, авторов, медиа, теги, метки времени и видимую вовлеченность.

Да. query должен быть непустой строкой. Эндпоинт не предоставляет встроенных фильтров по автору, компании, языку, типу контента, вовлеченности или сортировке.

В документации провайдера указаны last-hour, last-day, last-week, last-month и last-year. SocQ передает непустые строки, не проверяя это перечисление самостоятельно, поэтому поведение с другими значениями зависит от провайдера.

Это должно быть целое число от 10 до 2 000, кратное 10. По умолчанию 10.

Нет. Индексация Google, публичная доступность, ограничения курсоров провайдера, пустые страницы, повторяющиеся или отсутствующие курсоры могут остановить сбор раньше.

Нет. Этот эндпоинт выдает нормализованные записи публикаций. Для публичного обсуждения под выбранной публикацией используйте LinkedIn Post Comments с ее URL.

Каждая возвращенная публикация стоит 0,5 кредита SocQ, базовой платы нет. Оценка по умолчанию — 10 результатов, пустой набор результатов не оплачивается, а фактический расход может превысить оценку, если это допускается.