Banking services

Eligible sites

Banks and partners included in the register of financial platform operators (FPO) maintained by the Central Bank of Russia.

We accept offers from partners that allow users to apply for banking products on the FPO resource. The FPO should be listed in the Central Bank of Russia's registry.

What it adds to search results

The dedicated sections can contain information about banking services, such as exchange rates, mortgage terms, deposits, loans, debit and credit cards. They may also display reviews for these services and the banks. This helps users make an informed decision while enabling the bank to attract attention with advantageous services and deal terms.

How to set it up

To include your offers in such answers, provide up-to-date information about them to Yandex. You can do that by creating a YML feed and placing it on your site. The YML standard was developed by Yandex and is based on the XML standard.

The answer in search results will be generated from the feed data. Offers can also be automatically included in the response based on the processing of data from the Yandex search robot.

For answers to be displayed correctly, we recommend that you add every offer of the bank in the given category to the feed. For example, if there are 12 mortgage programs listed on the bank site, add all of them to the feed.

Feed restrictions

YML file size	50 MB
Number of `offer` elements	10,000
Total number of all YML files (service and offer feeds, RSS feeds for Turbo pages with content) for the site and its subdomains	1000

Because offers are displayed in separate dedicated sections, you need to create a feed for each of them and include links to those feeds in your request for enabling the sections.

Currency feed

Feed example

: Download

Field descriptions

Element	Type	Description
`URL`	string	A link to the page with exchange rates.
Currency
`From`	string	The currency code in ISO 4217 format. For example, USD, RUB, or EUR.
`To`	string	The currency code in ISO 4217 format. For example, USD, RUB, or EUR.
`AmountLowerLimit`	float	The minimum amount for the price to be valid.
`Nominal`	float	The number of currency units that the price is specified for.
`BuyPriсe`	float	The buying price for the set `Nominal`.
`SellPrice`	float	The selling price for the set `Nominal`.
`UpdateAt`	date time	The time when the price was updated, in ISO 8601 format with a time zone.
Price
`AmountLowerLimit`	float	The minimum amount for the price to be valid.
`Nominal`	float	The number of currency units that the price is specified for.
`BuyPriсe`	float	The buying price for the set `Nominal`.
`SellPrice`	float	The selling price for the set `Nominal`.
`UpdateAt`	date time	The time when the price was updated, in ISO 8601 format with a time zone.
Offices
`Namе`	string	The name of the bank (not branch).
Office object
`Namе`	string	The branch ID (name), unique for all branches in the feed.
`City`	string	The name of the branch's locality.
`Adress`	string	The address in the locality. You can specify the full address with the region and district.

You can also pass currency information via your API. To do this, fill out the form and enter your request in the field for comments.

Mortgage feed

Feed example

: Download

Field descriptions

Parameter	Type	Description
`generation-date*`	`date time`	The feed update time. Format: ISO 8601.
`offers*`	`array`	A list of offers. There should be only one instance of it in the document.
`banks*`	`array`	A list of banks. Stores bank metadata.
`references*`	`array`	A list of recommendations. Stores a list of regions.
offer object
`bankBic*`	`string`	The bank code (BIK). See the formats on this page.
`offerId*`	`integer`	The offer ID. Should be unique for each offer.
`purposeIds`	`dictionary`	The purpose IDs.
`name*`	`string`	The program name.
`description`	`string`	Program description.
`specialPrograms`	`array`	Special offers.
`isInAllRegions`	`boolean`	Whether the offer is available in all Russian regions.
`info`	`object`	Additional information about the program.
`regions`	`array`	Stores a reference list of regions. Each region should occur in the document only once.
`offerUrl`	`string`	A link to the offer page. UTM parameters are allowed.
`totalLoanCostMin`	`float`	The total loan amount, the lower boundary.
`totalLoanCostMax`	`float`	The total loan amount, the upper boundary.
`rateTables`	`object`	A table with rates and conditions.
`boosts`	`object`	Positive and negative rate adjustments.
`requirements`	`object`	The requirements that the client has to meet.
`additionals`	`object`	Conditions for early repayment and for the use of maternity capital.
`marketTypes`	`object`	Property market types.
`requiredDocuments`	`object`	The required documents.
`minIncome`	`float`	The minimum income.
`collateralRealEstateInfo`	`object`	Information about the mortgage collateral.
`requiredGuarantor`	`boolean`	Whether a guarantor is required. If yes, enter "1". Otherwise, enter "0".
`placeDeal`	`string`	Where the deal is registered. For example, a branch.
`registrationInCreditZone`	`boolean`	Whether the client has to be a resident of the area where the mortgage is issued. If yes, enter "1". Otherwise, enter "0".
`insurance`	`object`	Information about the necessity of insurance.
dependency (boostsDependencies / dependencies)
`main`	`string`	The ID of a surcharge or discount that has incompatible combinations.
`independent`	`string`	The ID of a surcharge or discount that can't be combined with `main`. There can be more than one.
limits (boostsDependencies)
`maxCombination`	`integer`	The limit on the number of surcharges or discounts applied at the same time. Can be omitted.
`maxBoost`	`float`	The maximum surcharge or discount amount. Can be omitted.
requirements object (offer)
`maxRedemptionAge`	`integer`	The maximum age of the client.
`minCurrentAge`	`integer`	The minimum age of the client.
`minTotalWorkExperience`	`integer`	Minimum duration of employment (in months).
`minLastPlaceWorkExperience`	`integer`	Minimum duration of employment on the last job (in months).
`otherRequirements`	`string`	Other requirements. You can specify multiple requirements separated by commas.
additionals object (offer)
`earlyRedemptionCondition`	`string`	Conditions for early repayment.
`maternityCapitalCondition`	`string`	Conditions for the use of maternity capital.
marketTypes object (offer)
`primary`	`boolean`	New-build property. If the offer extends to new-build properties, enter "1". Otherwise, enter "0".
`secondary`	`boolean`	Resale property. If the offer extends to resale properties, enter "1". Otherwise, enter "0".
requiredDocuments object (offer)
`proofForIncome`	`object`	Documents that serve as proof of income. There can be more than one.
`reviewApplication`	`object`	Documents required for reviewing the application. There can be more than one.
proofForIncome / requiredDocuments object
`document`	`string`	The document name.
collateralRealEstateInfo object (offer)
`required`	`boolean`	If mortgage collateral is required, enter "1". Otherwise, enter "0".
`typeEstate`	`string`	The type of mortgage collateral. For example, the property that the client is buying or a development project under construction.
insurance object (offer)
`needInsuranceLife`	`boolean`	Life insurance. If life insurance is required, enter "1". Otherwise, enter "0".
`needInsuranceTitle`	`boolean`	Title insurance. If title insurance is required, enter "1". Otherwise, enter "0".
specialProgram object (offer)
`url`	`string`	A link to the special program.
`specialProgramId`	`integer`	The program ID.
specialProgram object (references)
`item`	`object`	The purpose.
purpose object
`item`	`object`	ThesSpecial program.
item object (purpose / boost )
`title`	`string`	The program name.
`value`	`float`	The factor value as a percentage.
info
`item`	`object`	Additional information about the program.
item object (info)
`title`	`string`	The program name.
`text`	`string`	Description.
region object
`id`	`integer`	The region ID.
`name`	`string`	The region name.
rateTables
`rates*`	`array`	A list of tables with rates and conditions.
rate object
`initialPaymentPercentageMin`	`integer`	The minimum down payment percentage.
`initialPaymentPercentageMax`	`float`	The maximum down payment percentage.
`periodFromDays`	`integer`	The minimum loan term (in days).
`periodToDays`	`integer`	The maximum loan term (in days).
`amountFrom`	`integer`	The minimum loan amount.
`amountTo`	`integer`	The maximum loan amount.
`rate`	`float`	The interest rate.
bank object
`bic*`	`integer`	The bank code (BIK).
`name*`	`string`	The loan name for display in the dedicated section.
`url*`	`string`	A link to the page with exchange rates.
`favicon*`	`string`	A link to the bank’s logo. Use these ports: 80 and 443.

Deposits

Feed example

: Download

Field descriptions

Parameter	Type	Description
`generation-date*`	date time	The feed update time. Format: ISO 8601.
`offers*`	array	A list of offers. There should be one instance of it in the document.
`banks*`	array	A list of banks. Stores bank metadata.
`references*`	array	A list of recommendations. Stores a list of regions.
offer object*
`bankBic*`	string	The bank code (BIK). See the formats on this page.
`offerId*`	integer	The offer (deposit) ID. Should be unique for each offer.
`currency*`	string	The currency code of the deposit offer in ISO 4217 format.
`name*`	string	The deposit account name for display in the dedicated section.
`description`	string	A description of the deposit offer. Use only words and no digits.
`partialWithdrawal`	object	Whether partial withdrawal of funds is possible.
`refill`	object	Whether making additional deposits into the account is possible.
`preferentialTermination`	object	Whether a deposit account can be closed before maturity.
`interestPayment`	object	The availability of compound interest.
`info`	object	Additional information about the offer.
`clientType`	object	The client category that the option is available to.
`cardExpenses`	object	The minimum monthly card spending amount to qualify for the option.
`newMoneyOption`	object	The "New money" option.
`isOnline`	boolean	Whether a deposit account can be opened online.
`isInAllRegions`	boolean	Whether the deposit offer is available in all Russian regions.
`regions`	array	Stores a reference list of regions. Each region should occur in the document only once.
`offerUrl*`	string	A link to the offer page. UTM parameters are allowed.
`rateTables`	object	A table with rates and conditions.
`bonuses`	array	A list of bonuses.
bank object
`bic*`	integer	The bank code (BIK).
`name*`	string	The deposit account name for display in the dedicated section.
`url*`	string	A link to the bank site.
`favicon*`	string	A link to the bank’s logo. Use these ports: 80 and 443.
reference object
`regions`	array	Stores a reference list of regions. Each region should occur in the document only once.
region object
`id`	integer	The region ID.
`name`	string	The region name.
interestPayment
`capitalization*`	boolean	Possible ("1") or impossible ("0").
`monthly`	boolean	Every month.
`quaterly`	boolean	Every quarter.
`annually`	boolean	Every year.
clientType
`type*`	One of the listed values.	"any": No restrictions. "new": A new client. "subscriber": A client with a paid subscription. "premium": A premium client. "salary": A payroll client. "retired": A retiree. "veteran": A veteran or combatant.
`description`	string	An additional description of the client category.
cardExpenses
`cardName*`	string	The name of the card that the client gets with the debit account, or the card required for a higher interest rate.
`minExpensesSum*`	integer	The minimum amount the client has to spend per month in the debit account currency to qualify for a higher interest rate.
newMoneyOption
`has*`	boolean	If the offer matches this option, enter "1". Otherwise, enter "0".
`description`	string	A description of the option.
rateTables
`rates*`	array	A list of tables with rates and conditions.
rate object
`periodFromDays*`	integer	The minimum deposit term (in days).
`periodToDays*`	integer	The maximum deposit term (in days).
`amountFrom*`	integer	The minimum deposit amount.
`amountTo`	integer	The maximum deposit amount.
`rate*`	float	The interest rate.
bonus object
`title*`	string	The name of the bonus.
`description`	string	A description of the bonus.
`maxAmount`	integer	The maximum bonus amount.
`maxPercent`	float	The maximum bonus rate.
`promocode`	string	Promo code.
`endDate*`	date time	The promotion's end date and time.
info
`item`	object	Deposit conditions.
partialWithdrawal
`has*`	boolean	Possible ("1") or impossible ("0").
`description`	string	A description of the partial withdrawal conditions.
refill
`has*`	boolean	Possible ("1") or impossible ("0").
`description`	string	A description of the conditions for making additional deposits.
preferentialTermination
`has*`	boolean	Possible ("1") or impossible ("0").
`description`	string	A description of the conditions for closing the deposit before maturity.
item object
`title`	string	The condition name.
`text`	string	The condition details.

Loans

Feed example

: Download

Field descriptions

Parameter	Type	Description
sources — a list of sources.
`source`	object	The main information about the source.
`icon*`	string	The link to the icon.
`bic*`	string	The bank code (BIK).
`name*`	string	The bank name.
offers — a list of offers.
`offer`	object	The information about offers.
`name*`	string	The product name.
`offerUrl*`	string	The link to the product page.
`currency*`	string	The currency of the loan.
term	object	The loan term.
`min_value*`	integer	The minimum loan term (in months).
`max_value*`	integer	The maximum loan term (in months).
amount	object	The loan amount.
`min_value*`	float	The minimum loan amount. The filtered value. Ensure that option intervals don't overlap.
`max_value*`	float	The maximum loan amount.
credit_rate	object	The loan rate.
`min_value*`	float	The minimum loan rate.
`max_value*`	float	The maximum loan rate.
total_credit_cost	object	The full loan cost (FLC).
`min_value*`	float	The minimum FLC.
`max_value*`	float	The maximum FLC.
requirements	object	The borrower requirements.
`citizenship_rf*`	bool	Citizen of the Russian Federation.
`income*`	number	Income.
last_work_experience	object	Time on the last job.
`value*`	number	The number of years or months of employment with the organization.
`period*`	period	The period of employment with the organization. For example, 2007–2009 or 2009–present.
total_work_experience	object	Total duration of employment.
`value*`	number	The number of years or months of employment.
`period*`	period	The period of employment.
submission_age	object	The required age.
`value*`	number	Age (specific number).
`period*`	period	Age (specific period).
required_documents — array of documents required to submit an application.
`required_documents*`	document	The required document.
choosable_documents — array of optional documents.
`choosable_documents*`	document	Any additional document.

Reference lists

Documents

Parameter	Description
military_documents — military documents.
`certificate_of_nis_participant`	The certificate of participant in the Savings and Mortgage System (NIS).
`military_service_unfitness`	The certificate of unfitness for military service.
`military_service_attitude`	The documents regarding military service status.
`military_id`	Military ID.
`fov_employee_id`	The ID of an employee of a federal government agency.
`military_personnel_id`	The military serviceperson's ID.
employment_documents — employment documents.
`pfr_work_history`	The information on employment activities from the Pension Fund of Russia (PFR).
`employment_confirmation`	The documents that confirm employment.
`etc_extract`	The statement from the electronic employment record book.
`original_work_book`	The original employment record book / employment activity certificate.
`certified_work_copy`	The сertified copy of the employment record book / employment contract.
identity_registration — identity and registration documents.
`residence_registration`	The document confirming registration at the place of residence.
`overnment_services`	Gosuslugi.
`passport`	Passport.
`international_passport`	International passport.
`drivers_license`	Driver's license.
`snils`	The social security number (SNILS) / state pension insurance certificate (SSGPS).
`adi_reg`	The notification of registration in the individual (personalized) accounting system (ADIREG).
`inn`	The taxpayer identification number (INN).
family_documents — family documents.
`child_birth_certificate`	The child's birth certificate.
`child_citizenship`	The document that confirms the citizenship of children.
`disabled_child_category`	The document that confirms the status of a child with a disability.
`maternity_capital`	Certificate of the balance of maternity capital.
`marriage_certificate`	The marriage/divorce certificate.
financial_income_documents — financial documents and proof of income.
`bki_data_consent`	Consent to provide and obtain data from credit bureaus.
`no_income_confirmation`	Without proof of income.
`bank_form_certificate`	Statement on the bank's form.
`free_form_certificate`	Free-form statement.
`pension_amount`	The document that confirms the amount of the pension.
`salary_account_statement`	The payroll account statement.
`personal_bank_statement`	The personal bank account statement.
`3_ndfl`	The 3-NDFL declaration.
`2_ndfl`	The 2-NDFL declaration.
`income_tax_declaration`	The tax declaration on the income of individuals.
`alternative_income_sources`	Documents that confirm income from other sources.
`pfr_account_statement`	The statement on the PFR account status.
`income_tax_certificate`	The certificate of income and tax amounts for an Individual.

Currency

Currency code	Name
`EUR`	Euro
`USD`	US dollar
`RUB`	Russian ruble
`CNY`	Chinese yuan
`BYR`	Belarusian ruble
`KZT`	Tenge
`UZS`	Uzbekistani sum

Periods

Parameter	Description
`month`	Months.
`year`	Years.

Generator

You can generate a loan feed on this page.

Debit cards

Feed example

: Download

If there are multiple offers associated with the same card (for example, different loyalty programs, packages, or offers with and without a subscription), add each of them to the feed as a separate offer.

Field descriptions

Parameter	Type	Description
bank (banks) — bank details
`bic`	string	The bank code (BIK). See the formats on this page.
`name`	string	The bank name.
`fullName`	string	The legal entity name.
offers — a list of offers.
`bfd`	string in timestamp format	The offer start date.
`bdt`	string in timestamp format	The offer end date. If there is no specific date, enter a timestamp in the distant future. For example: `3333-12-27T10:00:00+03:00`.
`name`	string	The card name.
`description`	string	A description of the card.
cashback (offers)
`currency`	string	The unit of cashback.
`staticCashback`	list	Static (standard) cashback.
`partnersCashback`	list	Partner cashback.
`actionsCashback`	list	Promotional cashback.
`otherCashback`	list	Other cashback (non-standard mechanisms, such as cashback wheels).
`dynamicCashback`	list	Cashback choices with dynamic parameters.
staticCashback (cashback) / partnersCashback (cashback) / actionsCashback (cashback) / otherCashback (cashback)
`category`	string	A category, such as "Gas stations" or "Pharmacies".
`name`	string	The name of the cashback option or promotion.
`rateMin`	integer	The minimum cashback.
`rateMax`	integer	The maximum cashback.
`rateType`	string	The cashback unit: miles, points, or rubles.
`descr`	string	The cashback description.
`spendAmountMin`	float	The minimum spend.
`spendAmountMax`	float	The maximum spend.
`spendAmountType`	string	The unit of spend: miles, points, or rubles.
`valchange`	integer	The ratio of the spend to cashback (`rateMin` or `rateMax`).
`valchangeType`	string	The unit for expressing the ratio of the total spend to cashback (`rateMin` or `rateMax`).
`cbmax`	integer	The monthly cashback limit.
`cbmaxCurrency`	string	The cashback limit unit: miles, points, or rubles.
dynamicCashback (cashback)
`catcount`	integer	The number of category choices.
categories (dynamicCashback)	list	Categories.
`category (categories)`	string	Category.
`cbmax (categories)`	integer	The monthly cashback limit.
`cbmaxCurrency (categories)`	string	The cashback limit unit: miles, points, or rubles.
`rateMin (categories)`	integer	The minimum cashback.
`descr (categories)`	string	The cashback description.
`rateMax (categories)`	integer	The maximum cashback.
`rateType (categories)`	string	The cashback unit: miles, points, or rubles.
`currency (categories)`	string	The card's primary currency, a three-letter ISO 4217 code.
`cardCurrencies (categories)`	string	The card's additional currencies.
`paymentSystems (categories)`	string	The card's payment systems.
package (offers) — information about available packages
`name`	string	The package name.
cardLimits (offers) — information about card limit types
`name`	string	A description of the limit.
`oneOperationSum`	integer	The maximum amount in a single transaction.
`operationSumPerDay`	integer	Total transactions per day.
`operationSumPerMonth`	integer	Total transactions per month.
`cardTypes (offers)`	string	The card type.
`cardCategory (offers)`	string	The card category.
cashWithdrawalsOtherAtm (cashWithdrawals) — cash withdrawals from other banks' ATMs
`atmMinComMin`	integer	The minimum fee.
`atmMinComMax`	integer	The maximum fee.
`atmPercMin`	integer	The minimum percentage fee.
`atmPercMax`	integer	The maximum percentage fee.
`descr`	string	The fee description.
cashWithdrawalsUsAtm (cashWithdrawals) — cash withdrawals from the bank's ATMs
`atmMinComMin`	integer	The minimum fee.
`atmMinComMax`	integer	The maximum fee.
`atmPercMin`	integer	The minimum percentage fee.
`atmPercMax`	integer	The maximum percentage fee.
`descr`	string	The fee description.
limitDaily (cashWithdrawals) — cash withdrawal limits
`limitMin`	integer	The minimum limit.
`limitMax`	integer	The maximum limit.
incomeOnBalanceTypes (incomeOnBalance) — types of interest on the balance
`title`	string	The interest type name.
`conditions`	string	Conditions for getting interest.
`incomeOnBalanceMaxRate` (`incomeOnBalance`)	integer	The maximum interest rate.
`incomeOnBalanceMinRate` (`incomeOnBalance`)	integer	The minimum interest rate.
`features` (`offers`)	string	Card features, such as a payment sticker.
loyaltyProgram (offers) — loyalty program
`name`	string	Loyalty program name.
`descr`	string	A description of the loyalty program.
service (offers) — card maintenance
`minCost`	integer	The minimum maintenance fee.
`maxCost`	integer	The maximum maintenance fee.
`period`	integer	The period that the maintenance fee covers: a month, year, or day.
freeTerms (service) — terms of free maintenance
`title`	string	The terms title.
`conditions`	string	The terms of free maintenance.
paidTerms (service) — terms of paid maintenance
`title`	string	The terms title.
`conditions`	string	The terms of paid maintenance.
notifications (offers) — notification service
`minCost`	float	The minimum cost of notifications in rubles.
`maxCost`	float	The maximum cost of notifications in rubles.
`period`	string	The period that the notification fee covers: a month, year, or day.
`descrs`	string	A description of the notification service.
`offerUrl (offers)`	string	A link to the offer page.
`offerId (offers)`	string	The offer ID.
`pictures (offers)`	string	Links to the images of card designs.
subscription (offers) — subscription
`name`	string	The subscription name.
`minCost`	float	The minimum subscription fee.
`maxCost`	float	The maximum subscription fee.

Credit cards

Feed example

: Download

Field descriptions

Parameter	Type	Description
creditCardFeed — data about banks and their credit cards.
bank (banks) — bank details
`bic`	string	The bank code (BIK). See the formats on this page.
`name`	string	The bank name.
`fullName`	string	Full legal name of the bank.
`favicon`	string	A link to the bank’s logo. Supported formats: .ico, .svg.
offers — a list of credit cards and their terms.
`bfd`	string in timestamp format	The offer start date.
`bdt`	string in timestamp format	The offer end date. If there is no specific date, enter a timestamp in the distant future. For example: `3333-12-27T10:00:00+03:00`.
`name`	string	The card name.
`description`	string	A description of the card.
`paymentSystems`	string	Card payment systems (MIR, VISA, and so on).
`offerUrl`	string	A link to the offer page.
`pictures`	string	Links to the images of card designs.
cashback — the terms of refund.
staticCashback — static cashback.
`category`	string	A category, such as "Gas stations" or "Pharmacies".
loyaltyPrograms (staticCashback) — a list of loyalty programs.
`name`	string	Loyalty program name.
`currency`	string	Cashback currency: miles, points, rubles.
values (loyaltyPrograms) — cashback details.
`rateMin`	float	The minimum cashback.
`rateMax`	float	The maximum cashback.
`rateType`	string	The cashback unit: miles, points, or rubles.
`descr`	string	Description of cashback terms.
`spendAmountMin`	float	The minimum spend.
`spendAmountMax`	float	The maximum spend.
`spendAmountCurrency`	string	The currency of the spend amount.
`valchange`	float	The ratio of spend to cashback.
`valchangeType`	string	The unit of measurement for `valchange`.
`cbmax`	float	The monthly cashback limit.
`cbmaxCurrency`	string	The currency of the cashback limit.
dynamicCashback — selectable cashback with dynamic indicators.
`catcount`	float	The number of category choices.
creditLimits — information about card limit types.
`minValue`	float	The minimum credit limit.
`maxValue`	float	The maximum credit limit.
gracePeriod
`minDays`	float	The minimum number of days in the grace period.
`maxDays`	float	The maximum number of days in the grace period.
cardLimitsType(cardLimits) — information about card limit types.
`name`	string	A description of the limit.
`oneOperationSum`	float	The maximum amount in a single transaction.
`operationSumPerDay`	float	Total transactions per day.
`operationSumPerMonth`	float	Total transactions per month.
cashWithdrawalsOtherAtm (cashWithdrawals) — cash withdrawals from the ATMs of other banks.
`atmMinComMin`	float	The minimum fee.
`atmMinComMax`	float	The maximum fee.
`atmPercMin`	float	The minimum percentage fee.
`atmPercMax`	float	The maximum percentage fee.
`descr`	string	Cash withdrawal terms.
cashWithdrawalsUsAtm (cashWithdrawals) — cash withdrawals from the bank's ATMs.
`atmMinComMin`	float	The minimum fee.
`atmMinComMax`	float	The maximum fee.
`atmPercMin`	float	The minimum percentage fee.
`atmPercMax`	float	The maximum percentage fee.
`descr`	string	Cash withdrawal terms.
service (offers) — card maintenance fees.
`minCost`	float	The minimum maintenance fee.
`maxCost`	float	The maximum maintenance fee.
`period`	string	The period that the maintenance fee covers: a month, year, or day.
freeTerms (service) — free maintenance terms.
`title`	string	The terms title.
`conditions`	string	The terms of free maintenance.
notifications (offers) — notification service
`minCost`	float	The minimum cost of notifications.
`maxCost`	float	The maximum cost of notifications.
`period`	string	The period that the notification fee covers: a month, year, or day.
descr (notifications) — details about the notifications cost.
`title`	string	The terms title.
`conditions`	string	Description.

Reviews

If the partner's resource supports posting user reviews on banking products and banks, the partner may transmit such data along with the feed under the following conditions:

The partner is registered as a financial platform operator with the Central Bank of Russia.
The partner supports a mechanism for evaluating the activity of at least 10 banks. These banks must be on the Central Bank of the Russian Federation's list of credit institutions and registered in the Russian Federation.
The partner can embed review elements (author, text, date) in the Schema.org microdata or upload the feed to Yandex Webmaster on the page Services and offers in search results → Feeds and errors.

Submit a request

Terms

The site must ensure that the data is correct and the offers match the subject. It is also responsible for dissemination of illegal information. In the event the terms are violated, Yandex has the right not to use the site data for changing the display in the search results.

Errors when uploading a feed

In the data structure and format

Error code	Message	Description
`1`	`PE_SAX_UNKNOWN`	Unknown error of the XML parser `#{0}`. Please contact support.
`2`	`PE_SAX_XML_ERR_LTSLASH_REQUIRED`	Expected a closing tag: `</`.
`3`	`PE_SAX_XML_ERR_EMPTY_DOCUMENT`	Feed is empty.
`4`	`PE_SAX_XML_ERR_START_TAG_EXPECTED`	An opening tag is missing.
`5`	`PE_SAX_XML_ERR_PARSE_ENTITY_REF`	Invalid entity name.
`6`	`PE_SAX_XML_ERR_PARSE_START_TAG`	Invalid opening tag name.
`7`	`PE_SAX_XML_ERR_PARSE_ATTRIBUTE_NAME`	Invalid attribute name.
`8`	`PE_SAX_XML_ERR_UNSUPPORTED_VERSION`	Unsupported XML version `{0}`.
`9`	`PE_SAX_XML_ERR_ENTITY_REF_SEMICOLON`	A link to an entity.
`10`	`PE_SAX_XML_ERR_PREMATURE_END_OF_DATA`	A premature end of data in the `{0}` tag.
`11`	`PE_SAX_XML_ERR_UTF_8`	Detected a UTF-8 encoding error.
`12`	`PE_SAX_XML_ERR_PCDATA_INVALID_CHAR`	Unknown character with code `{0}` in PCDATA.
`13`	`PE_SAX_XML_ERR_OPENING_ENDING_TAG_MISMATCH`	The opening and closing tags don't match: `{0}` and `{1}`.
`14`	`PE_SAX_XML_ERR_CDATA_SECTION_NOT_FINISHED`	CDATA section doesn't end properly.
`15`	`PE_SAX_XML_ERR_EXTRA_CONTENT_AT_THE_END`	Unexpected content at the end of the feed.
`16`	`PE_SAX_XML_ERR_ENTITY_NOT_DEFINED`	Entity `&{0};` is undefined.
`17`	`PE_SAX_XML_ERR_XML_DECLARATION`	An XML declaration is allowed only at the start of the file.
`18`	`PE_SAX_XML_ERR_ATTRIBUTE_VALUE_MISSING`	Attribute `{0}` must have a value.
`19`	`PE_SAX_XML_ERR_ATTRIBUTES_CONSTRUCT`	Attributes have an invalid format.
`20`	`PE_SAX_XML_ERR_GT_EXPECTED`	A `>` character is missing.
`21`	`PE_SAX_XML_ERR_END_TAG_SYMBOL_EXPECTED`	Missing the closing tag for `{0}`.
`22`	`PE_SAX_XML_ERR_INTERNAL_ERROR`	Internal error.
`23`	`PE_SAX_XML_ERR_STANDALONE_VALUE`	The "standalone" attribute can be set only to `yes` or `no`.
`24`	`PE_SAX_XML_ERR_UNESCAPED_START_TAG_SYMBOL`	The `<` character in an attribute value must be escaped.
`25`	`PE_SAX_XML_ERR_ATTRIBUTE_VALUE_FORMAT`	Expected `\` or `'` for an attribute value.
`26`	`PE_SAX_XML_ERR_HEADER`	Invalid XML header declaration.
`27`	`PE_SAX_XML_ERR_INVALID_SEQUENCE`	Invalid sequence: `]]>`.
`98`	`PE_TOO_MANY_ERRORS`	Too many errors. Only the most important ones will be shown.
`99`	`PE_EXCEPTION`	A fatal parser error.
`100`	`PE_REFL_UNKNOWN_ATTR`	Unknown attribute `{0}` in the `{1}` tag. The data in it will be ignored.
`101`	`PE_REFL_UNKNOWN_TAG`	Unknown tag `{0}`. The data in it will be ignored.
`102`	`PE_REFL_NO_ONTEXT`	The `{0}` tag shouldn't contain text. The text will be ignored.
`103`	`PE_REFL_TAG_IS_SINGULAR`	The `{0}` tag can't be used more than once. The data in this tag's repeat occurrences will be ignored.
`104`	`PE_REFL_ATTR_IS_SINGULAR`	The `{0}` attribute in the `{1}` tag can't be used more than once. The data in this attribute's repeat occurrences will be ignored.
`105`	`PE_REFL_REQ_ATTR_IS_NOT_FILLED`	The required `{0}` attribute in the `{1}` tag doesn't have a value.
`106`	`PE_REFL_REQ_TAG_IS_NOT_FILLED`	The required `{0}` tag isn't filled.
`201`	`PE_COMMON_DEPTH`	Exceeded the maximum nesting depth of {0}.
`202`	`PE_COMMON_DUPLICATE_OFFER_ID`	The offer ID in the `{0}` field is a duplicate. Each offer must have a unique value in this field. This offer will be ignored. An example of the duplicate ID: `{1}`.
`203`	`PE_COMMON_NO_OFFER_ID`	No offer ID in the `{0}` field. Each offer must have a unique value in this field. This offer will be ignored.
`204`	`PE_COMMON_MAX_LIMIT_OFFERS`	Exceeded the maximum number of offers ({0}) in the feed.
`301`	`PE_PARSE_NOT_BOOL`	Expected a Boolean value ("true" or "false") in the `{0}` tag, not `{1}`.
`302`	`PE_PARSE_NOT_ENUM`	Unknown value `{2}` in the `{0}` tag. Expected one of the following values: {1}.
`303`	`PE_PARSE_NOT_INTEGER`	Expected an integer in the `{0}` tag, not `{1}`.
`304`	`PE_PARSE_NOT_UINTEGER`	Expected a non-negative integer in the `{0}` tag, not `{1}`.
`305`	`PE_PARSE_NOT_DOUBLE`	Expected a real number in the `{0}` tag, not `{1}`.
`306`	`PE_PARSE_NOT_POSITIVE_DOUBLE`	Expected a non-negative real number in the `{0}` tag, not `{1}`.
`307`	`PE_PARSE_INCORRECT_URL`	Invalid URL in the `{0}` tag: `{1}`.
`308`	`PE_PARSE_INCORRECT_IMAGE_URL`	Invalid image URL in the `{0}` tag: `{1}` (only ports 80 and 443 are allowed for valid URLs).
`309`	`PE_PARSE_INCORRECT_DATETIME`	Invalid date in the `{0}` tag: `{1}`. Dates must comply with the ISO 8601 standard.
`311`	`PE_PARSE_EXCESS_TAG`	Too many values in the `{0}` tag: {2} values found, while `{1}` is the limit. All the values over this limit will be ignored.
`313`	`PE_PARSE_TOO_BIG_VALUE`	In the `{0}` tag, the number `{2}` exceeds the limit of `{1}`.
`314`	`PE_PARSE_INCORRECT_PAIR`	Expected a pair of values separated by `{1}` in the `{0}` tag, not `{2}`.
`335`	`PE_PARSE_REQUIRED_FIELD_NOT_CORRECT`	Missing or invalid value in the required `{0}` tag. Without a valid value, the offer will be ignored.
`351`	`PE_PARSE_TOO_SMALL_VALUE`	In the `{0}` tag, the number `{2}` is lower than the minimum of `{1}`.
`357`	`PE_PARSE_VALUE_IS_OUT_OF_RANGE`	`{1}` is out of range for the `{0}` tag. The allowed range is `{2}`.
`358`	`PE_PARSE_REQUIRED_FIELD_DOES_NOT_EXIST`	The required `{0}` tag is missing or empty.
`359`	`PE_PARSE_VALUE_IS_NOT_UNIQUE`	The `{0}` tag requires unique values. The `{1}` value occurs more than once.

In a financial feed

Error code	Message	Description
`801`	`PE_UNISEARCH_FINANCE_NO_REFERENCES_FOUND`	No `<references>` section found in the feed. Make sure that this section is added and filled in correctly.
`802`	`PE_UNISEARCH_FINANCE_NO_BANKS_FOUND`	No list of banks found in the feed.
`803`	`PE_UNISEARCH_FINANCE_MISMATCH_REFERENCE`	The `{1}` tag contains the `{0}` value. No such value was found in the `{2}` list.
`804`	`PE_UNISEARCH_FINANCE_NO_PROGRAMMS_FOUND`	No list of programs found in the feed.
`805`	`PE_UNISEARCH_FINANCE_NO_REGIONS_FOUND`	No list of regions found in the feed.
`808`	`PE_UNISEARCH_FINANCE_INCORRECT_INITIAL_PAYMENT`	Incorrect down payment range in the `{0}` tag. The minimum is `{1}`. The maximum is `{2}`.
`809`	`PE_UNISEARCH_FINANCE_INCORRECT_PERIOD`	Incorrect loan term range in the `{0}` tag. The minimum is `{1}`. The maximum is `{2}`.
`810`	`PE_UNISEARCH_FINANCE_INCORRECT_AMOUNT`	Incorrect loan amount range in the `{0}` tag. The minimum is `{1}`. The maximum is `{2}`.
`811`	`PE_UNISEARCH_FINANCE_ALL_REGIONS_WITH_REGIONS_LIST`	The offer will be available in all regions because the `IsInAllRegions` flag is set. This flag has a higher priority than the list of regions.

Page updated: July 15, 2025.

Change history

Deleted information about the transfer of data on credit offers using the API.

Subscribe to updates

You can also go to

Was the article helpful?

Airline tickets

Quick answer