OLX Partner API за собственици на магазини

Ако продавате в OLX от магазин, OLX Partner API е това, което една добавка ползва, за да пише вместо вас. Ето как работи, без жаргона на разработчиците. Фактите са от порталите за разработчици на самия OLX, които прочетохме на 21.10.2026 и 29.10.2026.

Какво е OLX Partner API?

OLX го описва със спецификация OpenAPI на портала за разработчици на всяка държава, например developer.olx.bg. Спецификацията е публична, така че написаното по-долу може да се провери в нея. Петте спецификации за България, Румъния, Португалия, Украйна и Казахстан са еднакви до името на сървъра; полската добавя функции, например настройки за доставка и управление на поръчки.

Как работи достъпът?

Между добавката и акаунта ви в OLX стоят три стъпки:

1. Регистрирате приложение в портала за разработчици на вашата държава. OLX проверява всяко приложение ръчно и ви праща резултата по имейл. Не обявява нито срок, нито критерии. Стъпките са в как да регистрирате OLX приложение.
2. OLX ви дава Client ID и Client Secret. Те принадлежат на това единствено приложение.
3. Влизате в OLX веднъж и разрешавате достъпа. От този момент добавката държи токен за достъп, който важи около един ден, и токен за подновяване, който важи около един месец и се подновява при употреба.

Влизането използва стандартния протокол OAuth. Добавката никога не вижда паролата ви за OLX.

Защо всеки магазин има нужда от собствено приложение?

OLX издава ключа за конкретно приложение, а в условията му за API пише, че ключът е за едно приложение и не бива да се предоставя на трети лица. Собственикът на магазина, който е регистрирал приложението, отговаря за ключа и за всеки, на когото го е споделил. Затова една добавка никога не бива да ползва едно централно приложение за всички и затова Tidelist ви моли да регистрирате свое. Данните за достъп се пазят криптирани във вашата собствена база данни на WordPress и не се изпращат до сървърите на Tidelist.

Има и практическа полза. Обявите се публикуват от вашия акаунт, с вашите лимити и пакети, а достъпът можете да оттеглите в OLX по всяко време.

Какви са лимитите?

OLX позволява 4 500 заявки на IP адрес за пет минути. Над това адресът се блокира за 30 минути. Някои команди струват и повече от една заявка. Една добавка трябва да остава далеч под лимита и да изчаква, когато OLX поиска да забави. Tidelist публикува по една обява с пауза между тях и спира, ако OLX поиска плащане.

API ограничава и какво може да види една програма: само вашите обяви и публични справочни данни като дървото на категориите.

Какви правила за съдържанието прилага OLX?

OLX проверява всяка обява, а спецификацията изброява правилата:

• заглавието е от 16 до 150 символа, а описанието от 80 до 9 000;
• най-много половината от буквите могат да са главни;
• без имейл адрес, уеб адрес или телефон в заглавието и описанието;
• чист текст, не HTML;
• без препинателен знак три пъти подред;
• обяви само в последното ниво на дървото на категориите.

Пълният списък е в Правила за обяви в OLX: контролен списък. Не вярвайте само на нас за числата: те са в спецификацията на OLX, а OLX може да ги промени.

Има ли тестова среда?

Не. OLX не документира пясъчник. Тествайте с отделен акаунт в OLX и шепа обяви и ползвайте режим, който показва какво би било изпратено, преди да го изпрати. Това е една от причините Tidelist да започва в пробен режим и да ви иска да въведете PUBLISH преди всяка партида.

Какво се различава между държавите?

Интерфейсът е един. Различни са данните зад него: категории, атрибути, валута, езици, лимити и пакети, и няколко по-рядко ползвани функции. Например командата extend не е налична в Португалия и Украйна, а Украйна има зони с различни цени за някои категории.

Затова една добавка може да поддържа и шестте държави с един и същ код и затова само държавата, тествана с реален акаунт, заслужава думата „поддържана“. За Tidelist това е България. Полша, Румъния, Португалия, Украйна и Казахстан са в бета. Таблицата е на страницата WooCommerce към OLX.

Какво може да се обърка?

Реалният риск не е такса, а блокиране. Условията за API на OLX му позволяват да ви предупреди, да блокира ключ временно или за постоянно и да ограничи употреба, която рискува вреда за OLX или за други потребители. Затова публикувайте на малки, избрани от вас партиди, избягвайте дубликати и никога не оставяйте програма сама да купува или да трие обяви.

Готови ли сте да свържете магазин? Следвайте Свържете акаунта си в OLX. Tidelist не е свързан с OLX Group.