> ## 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.

# Python PyPI

> Клієнтський пакет Python PyPI для Ayrshare

## Огляд

[Пакет PyPI Social-Post-API](https://pypi.org/project/social-post-api/) від Ayrshare дозволяє інтегрувати API Ayrshare у Ваш додаток Python.

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

Встановіть [пакет PyPI Social-Post-API](https://pypi.org/project/social-post-api/), якщо Ви використовуєте Python на серверному боці. Пакет спрощує виклики, обгортаючи RESTful-виклики.

Почніть з отримання свого секретного API-ключа в [Панелі керування Ayrshare](https://app.ayrshare.com/api).

Далі встановіть пакет Python:

```bash theme={"system"}
pip install social-post-api
```

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

Приклади Post, History та Delete. Для отримання додаткової інформації див. [пакет PyPI](https://pypi.org/project/social-post-api/).

<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 містить помічник `set_twitter_byo(api_key, api_secret)`, який додає два необхідні заголовки `X-Twitter-OAuth1-*` до кожного наступного запиту:

```python theme={"system"}
from ayrshare import SocialPost

social = SocialPost(API_KEY)
social.set_twitter_byo(MY_X_API_KEY, MY_X_API_SECRET)

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

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

```python theme={"system"}
social.clear_twitter_byo().set_twitter_byo(next_tenant_key, next_tenant_secret)
```

```python theme={"system"}
from ayrshare import SocialPost
social = SocialPost('8jKj782Aw8910dCN') # отримайте API-ключ на ayrshare.com

# Обов'язково для будь-якого допису, що включає 'twitter' у platforms (BYO застосовується).
social.set_twitter_byo('YOUR_X_CONSUMER_KEY', 'YOUR_X_CONSUMER_SECRET')

# Публікація на платформах Twitter, Facebook і LinkedIn
postResult = social.post({'post': 'Nice Posting 2', 'platforms': ['twitter', 'facebook', 'linkedin'], 'profileKey': 'JKSDJI-JKKJKKJ'})
print(postResult)

# Видалення (використовуйте верхньорівневий ID допису Ayrshare з postResult['id'])
deleteResult = social.delete({'id': postResult['id']})
print(deleteResult)

# Історія
print(social.history())
```

### Profile Key

Ви можете вказати Profile Key для User Profile в тілі POST або запиті GET за допомогою поля `profileKey`.

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

<ul class="custom-bullets">
  <li>[Пакет PyPI](https://pypi.org/project/social-post-api/)</li>
  <li>[Репозиторій Github](https://github.com/ayrshare/social-post-api-python)</li>
  <li>[Обговорення проблем](https://github.com/ayrshare/social-post-api-python/issues)</li>
</ul>