Elbuz connects to your OLX account, pulls your ads into the base catalog, then updates prices on OLX, deactivates and reactivates ads by stock, and publishes new ones.
When you need this:
- Out of stock — the ad leaves OLX and returns with stock.
- You changed a price in the catalog — the export sends it to the ad.
- Your ads are already on OLX — they become catalog cards with photos and parameters.
- New products to list — Elbuz publishes ads and links them to cards.
Where to start: link your OLX account in an “OLX” template in the “Data import” window.
What the OLX connection does
- Ad import — the title, description, price, category, parameters and photos go into the card, and the ad status becomes availability.
- Prices and availability back to OLX — a changed price goes to the ad, zero stock deactivates it, non-zero stock activates it.
- Publishing — products without an ad are listed on OLX with the category's required parameters.
- Edit protection — the “Do not update” and “Fixed Price” toggles on the card.
The OLX partner has no orders — only ads and buyer messages. Buyers message or call you directly, and the marketplace doesn't create a document. Leaving the order import checkbox on breaks nothing: Elbuz writes to the log that orders aren't available via the API.
What you need from OLX
You don't need to register an app with OLX: just approve access to your account and enter a short link code. OLX access expires every day, and Elbuz renews it automatically.
- “Region” in the “Connection” card —
ua(Ukraine) orpl(Poland). It sets the marketplace you sign in to and the ad currency: hryvnia or złoty. - One link per account: connect OLX in the import template, and the export template uses the same access, and vice versa. Both have the “Connect” button and the code field.
- City and phone are needed only for publishing and are set in the export template (publishing).
How to connect, step by step
- Create a template of type “OLX” and save it — linking works only for a saved template.
- Enter ua or pl in the “Region” field.
- Click “Connect”, approve access on OLX, and paste the link code right away — it expires quickly.
- Click “Test connection”: the response should show the marketplace and the account name.
- Run the import manually and check that the ads landed in the catalog with prices, descriptions and photos.
- Put the template on a schedule, and set up prices and availability in a separate export template.
What goes into the card
| OLX data | Product field in Elbuz |
|---|---|
| ad title | Name |
| description | Description |
| price | Price |
| ad status | Status and availability |
| OLX category | Category |
| ad parameters | Attributes |
| photos | Photos (if the checkbox is on) |
On OLX a product has no quantity: an ad is either active or deactivated. An active ad gives a stock of 1, a deactivated one gives 0. It works the same in reverse: stock above zero activates the ad, zero deactivates it.
Attributes from an ad arrive with the internal OLX parameter code instead of a readable name. This isn't an error: Elbuz uses these codes to find the category's required parameters when publishing.
Categories the import creates
The import asks OLX for the ad's category name and looks for a category with the same name in your catalog; if there isn't one, it creates it. This is a single name, not the full OLX tree path. General rules: service categories and brands.
An ad without a category goes to the service category “Products - olx”: disabled, with “Export to file (to website)” off. While a product sits only there, the export skips it: its OLX price and availability don't update, and the log is silent. Move the card to your own category or enable export for the service category.
- You can move cards: a repeat import doesn't change their place in the tree, and the link to the ad is stored separately — the product side panel shows the line “ID olx #…”.
- The OLX category match is stored in your category. If you move a product to a category with no match, new ads aren't published for it; existing ones keep updating.
- You can delete attributes, but required parameters are built from them: a product missing one will stop being published.
What a repeat import does to your edits
A repeat run finds the card by name: OLX doesn't return an SKU for the ad, and the ad number isn't used for the lookup. The key is calculated once, when the card is created.
- You renamed the product in Elbuz — the card is still found by its original name, and the run silently restores the ad title.
- You changed the title in your OLX account — the run creates a second card next to it, and the old one keeps the last data.
Editing titles of already imported ads in your OLX account creates duplicates. Both cards are linked to the ad, so the export processes the ad twice, and the last price written wins. Remove the extra card right away.
| Card field | What the run does |
|---|---|
| Name, description, price, quantity, “enabled/disabled”, full category name | overwrites from the ad |
| Internal SKU, barcode, tags, old price | leaves alone — the ad has no such fields |
| Photos and attributes | adds only when the card is created |
| Place in the category tree | doesn't change |
To lock the whole card: the “Do not update” toggle in the “Import protection” section (in the “Products” grid, the “Do not update (flag)” column). Only the price: “Fixed Price”; the run still takes the name, description and availability from the ad. “Do not update” blocks all imports, not just OLX. General rules: how to lock your own value.
1
Do not update2
Fixed Price- Do not update — the import run skips this product card entirely.
- Fixed Price — the price from the import listing is not written to the product.
- Start or end
- Action or result
- Decision: the path depends on the answer
Whose price wins
- Markup rules skip cards from OLX: they calculate the price from the purchase price, and the ad doesn't have one. The ad price wins.
- The purchase price came from another source (for example, a supplier price list matched the card) — the next markup recalculates the price from it. To keep the ad price, use “Fixed Price”: markup skips products with it and with “Do not update”.
- Two sources for one card — the lookup is by name, so the field keeps the value from whichever run finished last. OLX doesn't overwrite the SKU, barcode, tags or old price written by another source. OLX doesn't touch the attributes of an existing card at all.
How to update prices and availability on OLX
The reverse direction is a separate export template of type “OLX”. For each linked ad, Elbuz does two things:
- Price — reads the ad and, if the price has changed, sends the whole ad: OLX accepts only complete ads, so everything else is carried over unchanged.
- Availability — activates or deactivates the ad based on stock.
- Start or end
- Action or result
- Decision: the path depends on the answer
The log writes “OLX: adverts processed: …” every 50 ads and, at the end, “OLX: prices and availability updated, adverts: … (errors: …)”. Errors here are only rejected price changes; the ad count shows how many ads were checked, not changed.
Rejected activations and deactivations are collected in an orange line “OLX: activate/deactivate commands rejected: …” with the count and the first rejection (product, command, reason). Often this just means the ad was already in the required state.
The price isn't sent when it's zero or when the ad couldn't be read — the run then moves on without a log entry, and the activate or deactivate command runs anyway.
How to publish new ads
Publishing is turned on by the “Publish new products” checkbox in the export template. Without it, products with no link are silently skipped. OLX ad requirements:
| OLX requirement | What it means for your catalog |
|---|---|
| Title from 16 to 150 characters | Elbuz pads a name that's too short up to the minimum by adding the category number and dots, so it's better to fix such a title in the card. Anything over 150 characters is cut off |
| Description from 80 characters | A product with a short description is skipped, with a log entry. The description is taken from the card without markup and cut off at 9,000 characters |
| Leaf OLX category | Must be matched to the product's category, otherwise the product is skipped |
| Required category parameters | Taken from product attributes by name; if any are missing, the product is skipped and the log lists them |
| City and phone | Entered in the export template in the “API version (marketplace parameters)” field as one line: region, city ID and phone separated by vertical bars — for example ua|1|380501234567 |
Without a city or phone, the log writes “OLX: city ID (city_id) or phone is missing - publishing is not possible. Fill them in the template”, and no new ads are created. Prices and availability of linked ads still update as usual.
For each product, Elbuz asks OLX for the category's required parameters, builds the ad — title, description, price in the region's currency, up to eight photos — and sends it. Once it gets the ad number, it immediately saves the “product — ad” link and sets the product's “Exported” flag.
- A line for each ad: “OLX: advert ‘name’ published (ID …)”.
- At the end — how many were published, skipped, and waiting for a paid package.
- New ads go through OLX moderation.
- Start or end
- Decision: the path depends on the answer
When the free ad limit is used up, OLX accepts the ad as “limited”: it's created but not shown without a package. Elbuz doesn't pay for such ads — it links them to the product and writes the line “OLX: ‘name’ created but needs a paid package…” with advice to activate it in your OLX account.
OLX.ua and OLX.pl categories
OLX.ua and OLX.pl have different category trees. The “Load marketplace dictionary” button in the category matching window (OLX tab) loads the categories of the region set in the “Region” field of the OLX import template, and the window shows exactly those: for pl, Polish categories, with ad prices in złoty.
Category matching with OLX categories is one per Elbuz account. If you switch the template region from ua to pl or back, match the categories again: the other region's categories won't fit.
Required parameters: how to fill them in
This is the top reason ads aren't published. Each leaf OLX category has its own required parameters — condition, size, brand, etc. Elbuz takes them from product attributes by parameter name or code, and for lists picks a matching option. If an attribute is missing, the ad is skipped and the log lists up to eight missing names.
Start with one category: publish a few products, check the log to see which parameters OLX requires, and create these attributes with exactly the same names. After that, the category will publish without skips.
Schedule and run size
Import and export templates are scheduled separately — how API source scheduling works.
- There's no cap. The import fetches ads in pages of 100 and writes them to the catalog in batches of 500. The export takes all products that passed the template's filters; in a demo account, no more than 100 per run.
- Requests to the marketplace: in the export, up to three per ad (read, write the price if it changed, activate or deactivate); two per published product; in the import, one per page plus one per new category.
- Timeouts: up to 120 seconds per request, 30 for the connection. On “too many requests”, up to three retries with pauses of two, four and six seconds; after that the import stops with an error.
- Stopping from the log: the import finishes reading and writing the current page; export and publishing don't check for a stop and run to the end of the list.
The log is kept in the Operations center, so you can close the window.
Scenarios
OLX ads should sit in the catalog alongside your other products
Setup: an “OLX” import template, account linked, “Products” turned on in the data selection and, if you need images, “Photo”.
Result: each ad becomes a card — an active one with stock 1, a deactivated one with 0. Every run brings back the name, description and price from the ad. Later photo changes in the ad don't reach an existing card.
A product is out of stock — its ad should disappear from OLX
Setup: an “OLX” export template with the “Products” checkbox, “Publish new products” off.
Result: stock above zero activates the ad, zero deactivates it. The price is sent only when it's above zero and differs from the ad. Products without a link are skipped; the run can't delete ads, only deactivate them.
You manage prices and descriptions in Elbuz, and the import must not overwrite them
Setup: “Do not update” in the card's “Import protection” section; for the price on OLX, an export template with the “Products” checkbox.
Result: the OLX import doesn't overwrite the card, and the export sends your price to the ad. To lock only the price, use “Fixed Price”.
What to do when OLX doesn't work as expected
| What you see | Why | What to do |
|---|---|---|
| Linking didn't work | The link code expires quickly | Get a new code and paste it right away (how to connect) |
| “OLX: activate/deactivate commands rejected: …” | Most often the ad is already in the required state; otherwise, moderation or a limit | Look at the first rejection in the line; sort out moderation and limits in your OLX account |
| The price on OLX didn't update | The price matches the ad, is zero, or the ad couldn't be read | Check the price on the card (prices and availability) |
| A product never gets into the export | It sits only in the service category “Products - olx” with export off | Move it to your own category (categories) |
| An ad doesn't get published | Short description, unmatched category, missing parameters, or no city and phone | Find the log line with the product name (OLX requirements) |
| The catalog has two cards for one ad | The title was changed in your OLX account after the import | Delete the extra card (repeat import) |
| The run broke off with an error | OLX returned an error or “too many requests” three times in a row | Run it again (broken-off run) |
If a run breaks off midway
General rules are in the overview. OLX specifics:
- The import, on an OLX error, writes everything it has read to the catalog, even an incomplete batch. Ads it didn't reach keep their old data. Rerunning is safe as long as nobody changed titles in the OLX account.
- Publishing saves the link for every OLX response that has an ad number, so a rerun catches up on the rest and doesn't publish linked products twice.
- A break at the moment of sending — the ad may already exist on OLX with no link in Elbuz, and the next run will publish it again. An error response gives a red line “OLX: advert publish error” with the reason; the product goes to the next attempt.
- Start or end
- Action or result
- Decision: the path depends on the answer
If you ran the wrong thing
- Find what was published. The run log (past runs — the “Run history” button in the template header) has a line for each ad. The product card has the “ID olx #…” line and an “On site” button that opens the ad; the link exists only for ads created by Elbuz.
- Deactivate the ads with zero stock and run the export again. Elbuz can't delete ads — do that in your OLX account.
- Prices on OLX: fix them in the catalog and run the export again — only changes are sent, and text, photos and parameters stay intact.
- Prices in the catalog can't be bulk-reverted after a wrong import. Affected products show up by “Update date”, created ones by “Source: name”, and the previous price is in “Product price history” if that tracking is on (general rollback steps).
Deleting a product in Elbuz isn't the same as removing its ad. The link disappears with the card, but the ad stays on OLX, and nothing can manage it anymore. If you add the product again with “Publish new products” on, a second ad appears. Deactivate the ad with zero stock first, then delete the cards.
FAQ
Why don't orders come in from OLX?
The OLX API has no orders: buyers contact the seller directly, and the marketplace doesn't create a document. Elbuz manages ads, prices and availability.
How is availability sent if an ad has no quantity?
Through visibility: stock above zero means the ad is active, zero means it's deactivated. In the other direction, an active ad comes in with stock 1, a deactivated one with zero.
What does a “limited” ad mean?
The free publishing limit is used up: the ad is created but not shown until you buy a package in your OLX account. Elbuz doesn't buy packages; it only reports this in the log.
What should I choose in the “Region” field?
ua for Ukraine, pl for Poland — this sets the marketplace, the currency, and the categories for category matching. The region must match the country of the connected OLX account (categories).
How do I take down ads published by mistake?
Set the products' stock to zero and run the export again. You'll have to delete the ads in your OLX account (steps).
Can I connect two OLX accounts?
No: there's one link per Elbuz account, and all OLX templates work with the same OLX account.
Where to find it and who has access
- Menu
- Operations → Data import → template of type “OLX”
- Prices, availability, publishing
- Operations → Data export → template of type “OLX”
- Access right
- the “Import” and “Export” windows in “Group permissions”
- Have ready
- your OLX sign-in; for publishing, a city and a phone number
1
Region field2
Connect button3
Link code field and Link store- Region — enter ua for Ukraine or pl for Poland.
- Connect — opens the OLX sign-in and issues a link code.
- Link code field and the Link store button — paste the code here and link the store.
Related topics
- If you need the big picture of API connections — importing a catalog via API.
- If an import overwrites your edits and you need to understand why — data import overview.
- If you sell on Prom alongside OLX — orders from Prom.ua.
- If you're deciding whether to list products on OLX from Elbuz — OLX integration.
- If you plan to sell on marketplaces — what it gives your store.
