• Import is suitable for companies with a large number of offers — products, real estate properties or services. You publish a file containing your entire catalog on your website, and our website downloads it approximately once an hour and uses it to create, update and withdraw your adverts. There is no need to submit and edit each advert manually. Connection and downloads are free.

    Such a file is called a feed. Its format is YML: an XML file that many online shops and content management systems can export.

    Will a programmer or an AI agent create the feed? Give them the instructions for an AI agent and programmer (in Russian). They contain all the file requirements, the questions the contractor should ask you, and a verification checklist. An AI agent (such as ChatGPT, Claude or Cursor) only needs this file attached to the task. If there is no one to create the feed, contact us using the feedback form.

    Contents

    How to connect import

    1. Prepare the feed according to the requirements in this article and publish it at a permanent address, for example https://your-website.com/export/catalog.xml. The address must open in a browser without a password.
    2. Save the link. Log in to the website and open the “Advert import” section in your dashboard. Paste the feed address and click “Save link”.
    3. Verify your website. A file named like partner-verification-….txt will appear in the “Site verification” block. Download it using the “Download file” button and place it in the root of the website whose address is specified in the feed's shop/url element. The file must open at https://your-website.com/partner-verification-….txt. This lets us confirm that the feed is published by the website owner.
    4. Check the feed. Click “Check feed”. Usually, after a few minutes, a report will appear in the “Last feed check” block. The check does not publish anything: it looks for errors in the file, verifies the confirmation file and downloads the list of your categories. Correct any errors and check the feed again — another check is available after 2 minutes.
    5. Select sections and a territory. In the “Categories and territory” block, select a section of our website or “Do not import” for each category from the feed. Specify the country, region and city: they will apply to all adverts. Click “Save settings”.
    6. Select contact details. In the “Contacts in adverts” block, choose what to show in adverts: name, email, phone, Telegram and additional contact details. The details themselves are taken from your profile and changed in the “My personal information” section. Confirm your consent to distribution and click “Save contacts”.
    7. Accept the terms. In the “Advert import terms” block, read the terms and click “I accept the advert import terms”.
    8. Submit an application. In the “Automatic import application” block, click “Submit application”. If something is not ready, the dashboard will show what it is. After an administrator approves the application, the first download will take place within an hour, and then the website will download the feed automatically.

    File requirements

    • The file must always contain the entire current catalog, not just the changes. An offer missing from the new version of the file is withdrawn from display.
    • The format is YML (XML) in UTF-8 or Windows-1251 encoding. A ZIP or GZ archive instead of XML is not suitable.
    • The address starts with http:// or https://, uses a standard port, requires no login or password, and is accessible from the internet.
    • The website downloads the feed with a program, not a browser. Bot protection — a captcha, browser check or IP-address blocking — must not block the feed, the verification file or the photos. Requests carry a User-Agent header containing PartnerImport — you can add it to the protection allowlist.
    • The server delivers the entire file in no more than 60 seconds. The size limit is 50 MB.
    • The limit is 1000 offers, including those withdrawn from sale. If you need more, contact us. A file over the limit is rejected in its entirety.
    • The limit is 150 categories, including parent and empty categories.

    Example feed:

    <?xml version="1.0" encoding="UTF-8"?>
<yml_catalog>
  <shop>
    <url>http://partner.example/</url>
    <categories>
      <category id="10">Carriers and bags</category>
    </categories>
    <offers>
      <offer id="SKU-0042" available="true">
        <name>Cat carrier</name>
        <url>http://partner.example/products/SKU-0042</url>
        <price>1500</price>
        <currencyId>RUB</currencyId>
        <categoryId>10</categoryId>
        <picture>http://partner.example/images/SKU-0042-main.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-side.jpg</picture>
        <picture>http://partner.example/images/SKU-0042-detail.jpg</picture>
        <description>New carrier. Size 48 × 32 × 30 cm. Collection in person.</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

    Download: this example, an example with all supported fields.

    What the website takes from the file

    shop/url — required
    Your website address. The verification file is placed in its root, and links to offer pages must lead to this same website.
    category — required
    Your categories. The id attribute is a positive integer that is unique within the file; parentId is the id of the parent category. In the dashboard, each category is mapped to a section of our website.
    offer, the id attribute — required
    A permanent offer identifier, up to 80 characters. The website uses it to recognise the offer during subsequent downloads.
    offer, the available attribute — optional
    true — display, false — withdraw from display. Without the attribute, the offer is considered available.
    name — required
    The advert title. Instead, you can specify type="vendor.model" on the offer and use the typePrefix, vendor and model elements.
    categoryId — required
    The id of the offer's category.
    description — required
    The advert text. HTML is allowed: the website removes the markup and preserves paragraphs.
    price — optional
    The price. Without a price, the advert is published with a negotiable price.
    currencyId — optional
    The price currency. Without it, roubles are used.
    url — optional
    The offer page on your website. It appears as the “Website” line in the advert.
    picture — optional
    Photos, up to 5. The first one is the main photo.

    Other YML elements — characteristics, discounts, delivery and others — are skipped by the website and listed in the report as a warning. This is not an error. All imported adverts receive the “Offer” type, while the section, territory and contact details are set in the dashboard, not in the file.

    Title and description

    The title and description are checked according to the same rules as adverts submitted manually. An offer that violates a rule is skipped, and the reason is shown in the report. Texts are not corrected or truncated automatically.

    • The title is up to 150 characters, and the description is up to 5000 characters. A description is required.
    • No links, email addresses or phone numbers: the website will add contact details to the advert itself. A sequence of 11 digits beginning with 7 or 8 is considered a phone number, even if it is an item code.
    • No words of 30 or more characters without spaces: separate long item codes and concatenated words with spaces.
    • The title must not contain the name of the city selected for the adverts in the dashboard.
    • No profanity or prohibited subjects: alcohol, tobacco, weapons, prescription medicines, gambling, credits and loans, and others.

    The “Check feed” button does not check these rules — downloads after the application is approved do. It does find an empty description and a missing categoryId: such offers appear in the report as errors. To avoid learning about text rule violations from the first report, check the texts in advance: the instructions for an AI agent and programmer (in Russian) describe the rules in detail.

    Price, currency and photos

    • The price is a number with a dot: 1500 or 1499.90, without spaces, commas or a currency symbol. The amount is rounded to a whole number: 1499.50 becomes 1500. If the price is missing, empty or equal to 0, the advert will show “negotiable”.
    • Supported currencies are RUB (or RUR), USD, EUR, AMD, KZT, GEL, BYN, UAH, AZN, KGS and RSD. The price is not converted using exchange rates.
    • Photos must be JPEG, PNG or WebP, up to 15 MB each. The website takes the first 5 links from picture.
    • The website identifies a photo by its link. To replace a photo, change the link — for example, the file name. The website will not detect a new file at the old link.
    • If a photo cannot be downloaded, the advert is still published, and the website will try again in approximately one day.

    How to update and withdraw offers

    • If the price, text or photos have changed, keep the same id. The website will update the same advert, preserving its address and publication date.
    • Do not change the id of existing offers and do not assign the id of a withdrawn product to another product. A new id means a new advert, while the old one will be withdrawn. Case matters: SKU-42 and sku-42 are different offers.
    • To withdraw an offer, specify available="false" or remove it from the file. The advert will be hidden and stored for 180 days: if the offer returns with the same id, the previous advert will return too. After 180 days, the advert is deleted.
    • Selecting “Do not import” for a category in the dashboard hides all its adverts immediately after the settings are saved.
    • An empty offer list <offers/> withdraws all adverts from display. If the offers element is missing from the file entirely, the file is considered corrupted and the adverts are not changed.
    • An advert deleted by a website administrator is not created again with the same id.

    Errors and reports

    The check report is shown in the “Last feed check” block, and the regular download report is shown in the “Last download” block. There are three kinds of messages.

    • File error — the file is not accepted and the adverts are not changed. Examples: corrupted XML, missing shop/url, a limit exceeded, or an unverified website.
    • Offer error — only this offer is skipped: no new advert is created, and an existing one keeps its previous data. The other offers are processed, and the download result is “Partial”.
    • Warning — does not affect publication. Examples: extra elements in the file, a missing available attribute, or a photo that could not be downloaded.

    If you cannot correct an error, pass the report text to your programmer or AI agent together with the instructions — they explain what to correct for each message.

    If the file stops downloading

    While the file cannot be accepted — the server is unavailable, the file contains an error, or the verification file has disappeared — the adverts remain at their last accepted version. If this continues:

    • after 24 hours, you will receive an email explaining the reason;
    • after 7 days, all adverts in the connection will be hidden, and downloads will become less frequent — once a day;
    • after 180 days, import will stop and the adverts will be deleted.

    As soon as the file is accepted again, the adverts return to the website.

    Managing adverts

    • Imported adverts cannot be edited or deleted on the website: they show “Managed by feed” instead of “Edit”. Change their data in the feed.
    • The list of your adverts provides “Suspend display” and “Close ad” (move to the archive). Returning an offer to the feed does not cancel these actions.
    • In the “Advert import” section, you can pause import, hide all adverts, change the feed address or stop import and delete all adverts.

    The import service conditions are set out in the Advert import terms document. Ask questions through the feedback form.