Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Yandex action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Find businesses and places on Yandex Maps for a keyword in a city, with address, phone, website, categories, rating, review count, coordinates and open-now status. | $1.39 per 1,000 requests | Normal |
Marketmarket | Compare products on Yandex Market for a search term, with price, rating, review and purchase counts, shop name and rating, and stock. | $1.39 per 1,000 requests | Normal |
Reviewsreviews | Collect reviews of a business on Yandex Maps, up to 200 per call, with text, score, date, likes and dislikes, and the owner's reply. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Yandex action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Find businesses and places on Yandex Maps for a keyword in a city, with address, phone, website, categories, rating, review count, coordinates and open-now status. | keyword | category, lang, language, location, max_price, min_price, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform |
marketMarket Compare products on Yandex Market for a search term, with price, rating, review and purchase counts, shop name and rating, and stock. Set the city with | keyword | city, max_price, min_price, region, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform |
reviewsReviews Collect reviews of a business on Yandex Maps, up to 200 per call, with text, score, date, likes and dislikes, and the owner's reply. Pass a map place link or business ID, not a Market product link; | url | language, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
What do the Yandex search parameters mean?
Find businesses and places on Yandex Maps for a keyword in a city, with address, phone, website, categories, rating, review count, coordinates and open-now status. location defaults to Moscow and category narrows the place type; ratings do not confirm availability or quality.
keywordRequired- Specifies search terms for Yandex actions, targeting local places in search and e-commerce items in market. Map listings and product catalogs query separate underlying datasets.
categoryOptional- Filters place categories for the Yandex search action (e.g., restaurants, cafes, coffee_shops, hotels, or none to clear). This parameter does not apply to Yandex Market product categories and must align with the specified keyword and city.Allowed values:
atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsYandex Maps: Business Profile Cards, Categories, and Ratings — Official profile card documentation outlines business category, address, rating, review count, and operating information. This explains map objects; the presence of buttons on profile cards does not imply that this API provides booking or map editing capabilities. · Checked langOptional- Sets the response language for the Yandex search action, accepting ru, en, kk, tr, or uk. This controls search interface locale and does not guarantee translation of user-generated review content.Allowed values:
enkkrutruk languageOptional- Sets the fallback interface language for Yandex actions, defaulting to ru for search and en for reviews. Explicitly passing lang on the search action overrides this parameter.
locationOptional- Sets the target city for the Yandex search action, defaulting to Moscow. This parameter takes city names and is distinct from numeric Yandex Market region IDs.
max_priceOptional- Sets the upper price boundary for the targeted Yandex action when used in conjunction with min_price. It does not filter by maximum user rating.
min_priceOptional- Sets the lower price limit for Yandex actions, representing product price on market and local place price tier on search. These values reflect target-platform price points rather than API usage fees.
sortOptional- Controls sorting order per Yandex action. Accepts relevance or distance for search; popular or top_rated for market; and newest (default), relevance, top_rated, or lowest_rated for reviews. Values cannot be used across different actions.Allowed values:
distancerelevance
What do the Yandex market parameters mean?
Compare products on Yandex Market for a search term, with price, rating, review and purchase counts, shop name and rating, and stock. Set the city with city or the numeric region code, which defaults to Moscow; nothing is ordered and stock is not guaranteed.
keywordRequired- Specifies search terms for Yandex actions, targeting local places in search and e-commerce items in market. Map listings and product catalogs query separate underlying datasets.
cityOptional- Specifies the target city slug (e.g., moscow, saint_petersburg) for the Yandex market action. Must match an allowed enum value and cannot be substituted for location on map searches.Allowed values:
chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgYandex Market: Delivery Conditions Depend on City and Product — Official Yandex Market delivery terms tie shipping methods, schedules, and fees directly to the city and specific product, with exact conditions shown on product and checkout pages; this serves to clarify that initial product search prices do not constitute a guaranteed final delivery total or delivery commitment. · Checked max_priceOptional- Sets the upper price boundary for the targeted Yandex action when used in conjunction with min_price. It does not filter by maximum user rating.
min_priceOptional- Sets the lower price limit for Yandex actions, representing product price on market and local place price tier on search. These values reflect target-platform price points rather than API usage fees.
regionOptional- Accepts a numeric city region code for the Yandex market action, defaulting to 213 (Moscow). This is an internal region identifier, not an RU country code. Providing an explicit city parameter overrides this setting.
sortOptional- Controls sorting order per Yandex action. Accepts relevance or distance for search; popular or top_rated for market; and newest (default), relevance, top_rated, or lowest_rated for reviews. Values cannot be used across different actions.Allowed values:
populartop_rated
What do the Yandex reviews parameters mean?
Collect reviews of a business on Yandex Maps, up to 200 per call, with text, score, date, likes and dislikes, and the owner's reply. Pass a map place link or business ID, not a Market product link; sort can put lowest_rated complaints first.
urlRequired- Specifies a full Yandex Map place URL or a direct businessId string for the reviews action. This parameter does not accept Yandex Market product links.
languageOptional- Sets the fallback interface language for Yandex actions, defaulting to ru for search and en for reviews. Explicitly passing lang on the search action overrides this parameter.Yandex Maps: Original Reviews and UI Translations — Official Yandex documentation states that reviews written in a language different from the interface language may display translations alongside an option to switch back to the original text; therefore, the language parameter in this API cannot be treated as a direct filter for the review's original written language or as a translation guarantee. · Checked
sortOptional- Controls sorting order per Yandex action. Accepts relevance or distance for search; popular or top_rated for market; and newest (default), relevance, top_rated, or lowest_rated for reviews. Values cannot be used across different actions.Allowed values:
lowest_ratednewestrelevancetop_rated
How to use the Yandex API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Yandex API questions
What can I retrieve with the Yandex API?
Set platform to yandex. The current catalog lists search, market, and reviews. These action names identify different Yandex objects or views; they are not interchangeable search modes.
Which input starts a Yandex `search` request?
Specifies search terms for Yandex actions, targeting local places in search and e-commerce items in market. Map listings and product catalogs query separate underlying datasets. Send it as keyword inside params.
Which fields can Yandex `search` return?
Its declared schema includes name, text, address, and city. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Yandex action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.