> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js NPM

> Інтеграція Ayrshare API у ваш Node-застосунок за допомогою Social API NPM Package

## Огляд

[Social API NPM Package](https://www.npmjs.com/package/social-media-api) від Ayrshare дозволяє інтегрувати Ayrshare API у ваш застосунок Node.js.

### Встановлення

Встановіть Social API NPM Package, якщо ви використовуєте Node на серверній стороні.
Пакет спрощує виклики, обгортаючи RESTful-виклики.

```bash theme={"system"}
npm i social-media-api
```

<Info>Отримайте свій секретний API Key у [Ayrshare Dashboard](https://app.ayrshare.com/).</Info>

### Загальне використання

Приклади Post, History та Delete:

<Info>
  **Публікація в X/Twitter?** З 31 березня 2026 року операції X/Twitter через Ayrshare потребують ваших власних облікових даних X Developer App — Ayrshare застосовує це до кожного виклику, спрямованого на X. Додайте 2 BYO-заголовки до вашого запиту. Докладніше див. [посібник з налаштування](/dashboard/connect-social-accounts/x-twitter-byo-keys).
</Info>

Починаючи з v1.3.0, SDK містить помічник `setTwitterByo(apiKey, apiSecret)`, який додає два необхідні заголовки `X-Twitter-OAuth1-*` до кожного наступного запиту:

```javascript theme={"system"}
const SocialPost = require("social-media-api");
const social = new SocialPost(API_KEY)
  .setTwitterByo(MY_X_API_KEY, MY_X_API_SECRET);

await social.post({
  post: "Hello from BYO",
  platforms: ["twitter"]
});
```

Використовуйте `clearTwitterByo()`, щоб прибрати заголовки — корисно, коли ви повторно використовуєте один екземпляр SDK для кількох tenants:

```javascript theme={"system"}
social.clearTwitterByo().setTwitterByo(nextTenant.key, nextTenant.secret);
```

```javascript theme={"system"}
const SocialPost = require("social-media-api");
const API_KEY = "API KEY"; // get an API Key at ayrshare.com
const social = new SocialPost(API_KEY);

const run = async () => {
  /** post */
  const post = await social
    .post({
      post: "One more time",
      platforms: ["twitter", "facebook", "linkedin"],
      profileKey: "DJKJDK-SKDJKDJF" // used with a User Profile
    })
    .catch(console.error);
  console.log(post);

  /** history */
  const history = await social.history().catch(console.error);
  console.log(history);

  /** delete */
  const deletePost = await social.delete({ id: post.id }).catch(console.error);
  console.log(deletePost);
};

run();
```

### Відео-огляд Social Media API NPM Package

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/OMtj2h6sW6U" title="Social Media API NPM Package" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</div>

Публікація в соціальних мережах через API

### Profile Key

Ви можете вказати Profile Key для User Profile у тілі POST або в query GET, використовуючи поле `profileKey`.

### Демо Social API

Для прикладу інтеграції з Node.js (з використанням RESTful API-викликів) див. репозиторій GitHub:

<Card title="Демо-код Social API" icon="github" href="https://github.com/ayrshare/social-api-demo" horizontal>
  Social API Demo — це вебзастосунок, який дозволяє користувачам створювати, планувати та публікувати вміст на кількох платформах соціальних мереж одночасно.
</Card>

### Додаткова інформація та документація

<ul class="custom-bullets">
  <li>[NPM Package](https://www.npmjs.com/package/social-media-api)</li>
  <li>[Github Repository](https://github.com/ayrshare/social-media-api)</li>
  <li>[Issue Discussion](https://github.com/ayrshare/social-media-api/issues)</li>
</ul>