↑↓ selectEnter openEsc close

    1. Elbuz
    2. Ukrainian marketplaces

    How to manage OLX ads from Elbuz

    27 min readUpdated

    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) or pl (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

    1. Create a template of type “OLX” and save it — linking works only for a saved template.
    2. Enter ua or pl in the “Region” field.
    3. Click “Connect”, approve access on OLX, and paste the link code right away — it expires quickly.
    4. Click “Test connection”: the response should show the marketplace and the account name.
    5. Run the import manually and check that the ads landed in the catalog with prices, descriptions and photos.
    6. Put the template on a schedule, and set up prices and availability in a separate export template.

    What goes into the card

    OLX dataProduct field in Elbuz
    ad titleName
    descriptionDescription
    pricePrice
    ad statusStatus and availability
    OLX categoryCategory
    ad parametersAttributes
    photosPhotos (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 fieldWhat the run does
    Name, description, price, quantity, “enabled/disabled”, full category nameoverwrites from the ad
    Internal SKU, barcode, tags, old priceleaves alone — the ad has no such fields
    Photos and attributesadds only when the card is created
    Place in the category treedoesn'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.

    The “Import protection” section of the product card with its toggles
    1Do not update
    2Fixed Price
    1. Do not update — the import run skips this product card entirely.
    2. Fixed Price — the price from the import listing is not written to the product.
    What a repeat import does to one card. Left branch: the card is created for the first time, and only then does it get photos and attributes. Right branch: the card already exists, and the “Do not update” toggle decides everything.
    noyesnoyesyesnoAd from OLXIs there a cardwith this name in the catalog?New cardwith attributesIs the “Photo”checkbox on?Photos from the adare added to the cardCard without photosIs “Do not update”on in the card?Card stays unchangedName, descriptionand availability overwritten; price toounless“Fixed Price”Photos and attributesstay as they were
    • 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.
    The path of one product through the export. The price goes through three checks and may silently not be sent, while the activate or deactivate command is sent for every linked ad regardless.
    noyesnoyesyesyesyesnononoyesnoProduct passed the template filtersLinkedto an ad?“Publish newproducts” on?Queued for publishingSkipped, no log lineProduct priceabove zero?Ad readsuccessfully?Ad pricedifferent?Ad is sentwith the new priceStockabove zero?Activate commandDeactivate command
    • 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 requirementWhat it means for your catalog
    Title from 16 to 150 charactersElbuz 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 charactersA 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 categoryMust be matched to the product's category, otherwise the product is skipped
    Required category parametersTaken from product attributes by name; if any are missing, the product is skipped and the log lists them
    City and phoneEntered 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.
    The first check — city and phone — stops publishing for all products at once. The other checks apply to each product separately, and a skip due to an unmatched category is visible only in the summary line.
    noyesnoyesnoyesnoyesnoyesProducts without a linkCity ID and phoneset in the template?Log lineno ads at allProduct categorymatched to an OLX category?Skippedvisible only in the summaryDescription of80+ characters?Skippedlog lineAll requiredcategory parameters present?Skippedlist in the logDid OLX acceptthe ad?Red lineproduct stays unlinkedLink and “Exported”limited ad waits for a package
    • 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

    Common problems
    What you seeWhyWhat 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.
    The import cycle: pages of 100 ads, written to the catalog in batches of 500. An OLX error stops paging, but everything already read is written to the catalog. Stopping from the log lets the current page finish and be written.
    yesnoyesnoyesnoImport startsRequest a pageof 100 adsDid OLX returnan error?Log linepaging stoppedEverything read is writtento the catalogRun finished with an errorAds go into a batchevery 500 are written to the catalogStopclicked?Rest of the batchis written to the catalog100 adson the page?Catalog imported
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    If you ran the wrong thing

    1. 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.
    2. Deactivate the ads with zero stock and run the export again. Elbuz can't delete ads — do that in your OLX account.
    3. Prices on OLX: fix them in the catalog and run the export again — only changes are sent, and text, photos and parameters stay intact.
    4. 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
    OLX import template: the Connection card with the region field, and the card with the Connect button and the link code field
    1Region field
    2Connect button
    3Link code field and Link store
    1. Region — enter ua for Ukraine or pl for Poland.
    2. Connect — opens the OLX sign-in and issues a link code.
    3. Link code field and the Link store button — paste the code here and link the store.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free