Инструкция по Threads API

Threads API: Публикации — Публичные посты

Получайте данные по сущности «Публикации» из Threads через точечную операцию «Публичные посты» и подключайте результат к продуктовым процессам.

Метод подходит, когда известен входной идентификатор или параметр и требуется предсказуемый API-ответ по одному сценарию.

Метод GET
Сущность Публикации
Версии 2
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит публичные данные «Публикации» и служебный контекст, необходимый для последующих API-запросов.

Когда использовать

Метод подходит, когда известен входной идентификатор или параметр и требуется предсказуемый API-ответ по одному сценарию.

Типовые сценарии использования

Точечное получение данных

Запрашивайте только нужный объект без загрузки более тяжёлых коллекций.

Обогащение продукта

Добавляйте результат Threads API в карточки, процессы и внутренние инструменты.

Оркестрация запросов

Используйте ответ как вход для соседних методов и многошаговых сценариев.

Доступные версии

Версия ответа

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

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

Как использовать

Как вызвать метод

Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.

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

Общие параметры
Параметр Обязателен Тип Пример Описание
cursor Нет str | None QVFIUmVhZF9jdXJzb3I= Курсор следующей страницы из предыдущего ответа. Не передавайте его для первой страницы.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/threads.net/posts/public-posts

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/threads.net/posts/public-posts" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  # Optional parameters:
  # --data-urlencode 'cursor=QVFIUmVhZF9jdXJzb3I='
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

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

V2 — JSON

Проверенный пример

Компактный JSON-пример сформирован из последней успешной проверки версии V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": {
      "after": "GnbC8oyxkoKVnm-M7qWJmd2enW-QlozYo-GCnW-S8pS5zf32nG-QyoDaqtiYnm_wk_LoqouTnW_626-xg__nnG8m3KGLv6doFApZCBgAGgg6BhkMAA=="
    },
    "has_more": true
  },
  "search_context": {},
  "data": {
    "count": 5,
    "items": [
      {
        "owner": {
          "user_id": "63626552478",
          "username": "nytimes",
          "name": "The New York Times",
          "is_verified": true,
          "avatar_url": null
        },
        "media_id": "4007401219597157624_63626552478",
        "created_at": "2026-10-14T00:58:00Z",
        "type": null,
        "media_type": 19,
        "shortcode": "DedJi1WjkT4",
        "caption": "Joni Mitchell, the Canadian folk singer known for defining the genre, took her oath at a U.S. citizenship ceremony on Tuesday. She captioned her social media post: “A journey th…",
        "hashtags": [],
        "emails": [],
        "is_reply": false,
        "is_sponsored": null,
        "sponsored_detection_source": null,
        "sponsored_detection_confidence": null,
        "is_post_unavailable": false,
        "engagement": {
          "likes_count": null,
          "comment_count": 374,
          "repost_count": 38,
          "quote_count": 26,
          "reshare_count": 42,
          "view_count": null
        },
        "assets": []
      },
      {
        "owner": {
          "user_id": "65743876192",
          "username": "blacchyna",
          "name": "Angela R. White",
          "is_verified": true,
          "avatar_url": null
        },
        "media_id": "4007686934721830049_65743876192",
        "created_at": "2026-10-14T10:25:36Z",
        "type": "video",
        "media_type": 2,
        "shortcode": "DeeKgiTEZyh",
        "caption": "My hair is growing out fast ❤️ using the hair growth oil. Next I’m getting a trim ✅",
        "hashtags": [],
        "emails": [],
        "is_reply": false,
        "is_sponsored": null,
        "sponsored_detection_source": null,
        "sponsored_detection_confidence": null,
        "is_post_unavailable": false,
        "engagement": {
          "likes_count": null,
          "comment_count": 305,
          "repost_count": 9,
          "quote_count": 8,
          "reshare_count": 311,
          "view_count": null
        },
        "assets": [
          {
            "id": "4007686934721830049_65743876192",
            "type": "video",
            "url": "https://scontent-cdg4-2.cdninstagram.com/o1/v/t2/f2/m86/AQNj8geYBlfin09L5sXH8_KvI5NbwAwkcovrTeGXvPmQ-6wnbviJ1MGwqDs_Dl6cgxW4MW7evypi4KpNUXbULaHZ0-rRPXd0VpHCyM0.mp4?_nc_cat=109&_…",
            "height": 1920,
            "width": 1080,
            "accessibility_caption": null
          }
        ]
      },
      {
        "_more_items": 3
      }
    ]
  }
}
Что делать дальше

Продолжить оценку API-метода

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

Открыть страницу Threads API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

Откройте стартовую документацию, чтобы быстро проверить аутентификацию, версионирование, повторы запросов и различия между тестовым и рабочим API.

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод Threads API?

Метод выполняет операцию «Публичные посты» для сущности «Публикации». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.