Returns information about the current advertiser account (login, currency, type, country) using the Yandex Direct clients service.

Returns today's API points quota (spent / rest / limit) from the Units header, so you can avoid hitting the daily limit.

Lists campaigns with optional filtering by id, type, state and status. Monetary fields (e.g. DailyBudget.Amount) are returned in account currency units.

Creates a TextCampaign (Text & Image ads). Without biddingStrategy it defaults to manual search bids with the network off (Search HIGHEST_POSITION, Network SERVING_OFF); pass a full biddingStrategy {Search, Network} to use an auto-strategy or enable the network.

Performs a lifecycle action on campaigns by id: suspend, resume, archive, unarchive or delete.

Updates a campaign's name, end date and/or daily budget (campaigns/update).

Lists ad groups. Provide campaignIds and/or ids — the Yandex Direct API requires at least one selection criterion.

Creates an ad group inside a campaign with a target geo.

Updates an ad group's name and/or target regions (adgroups/update).

Deletes ad groups by id (adgroups/delete). Deleting a group also removes its ads and keywords; this cannot be undone.

Lists ads with optional filtering by campaign, ad group, id, state and status.

Creates a text ad (TextAd) inside an ad group. New ads start as drafts.

Performs a lifecycle action on ads by id: moderate, suspend, resume, archive, unarchive or delete.

Updates a text ad's title, text or landing page (ads/update). Editing an active ad sends it back to moderation.

Lists keywords filtered by campaign, ad group or id. Bid and ContextBid are returned in account currency units.

Adds keywords to an ad group, with optional search and network bids.

Performs a lifecycle action on keywords by id: suspend, resume or delete.

Sets manual search/network bids on keywords, or on all keywords in given ad groups or campaigns (keywordbids/set). Bids are in account currency units.

Requests a performance report via the Yandex Direct Reports service. By default the report is AGGREGATED over the whole period (one row per object) — add "Date" to fieldNames only for day-by-day dynamics or trend questions. ALL_TIME without a campaign filter is rejected for SEARCH_QUERY/CRITERIA reports; pass campaignIds or a bounded date range. SEARCH_QUERY_PERFORMANCE_REPORT returns a COMPUTED SUMMARY (totals over ALL rows + top-N detail + tail rollup + zero-click/zero-conversion counts), not raw rows — shape it with sortBy/topN/minCost/queryContains/zeroClicksOnly/zeroConversionsOnly, and add Conversions to fieldNames for conversion-based counts. Other report types return tab-separated rows (no header).

Looks up geo region ids for targeting (the regionIds that create_ad_group needs). Filter by a name substring; results are capped by limit.

Returns Yandex Direct reference dictionaries (currencies, time zones, constants, ad categories, ...). GeoRegions can be very large — prefer get_regions for region lookups.

Escape hatch to call any Yandex Direct API v5 service/method directly (e.g. service "bidmodifiers", method "get"). Use this for services that have no dedicated tool. Money is in micros (no conversion). Read methods (get/has/check) run freely; any other method is a write and requires confirmWrite=true.

Reads bid adjustments (mobile, desktop, demographics, retargeting, regional, video) for campaigns or ad groups. BidModifier is a percentage, not money.

Adds a bid adjustment to a campaign or ad group. BidModifier values are percentages per the API (e.g. 0–1300), not money.

Changes the percent of existing bid modifiers and/or enables/disables them (bidmodifiers/set), by modifier id.

Deletes bid modifiers by id (bidmodifiers/delete).

Reads sitelink sets (быстрые ссылки) by id. The API requires set ids — get them from ads' SitelinkSetId.

Creates a sitelink set (1–8 links). Sets are immutable — to change links, create a new set and reassign it to the ad.

Deletes sitelink sets by id (only sets not assigned to any ad can be deleted).

Lists callouts (уточнения) from the adextensions library. Attach a callout to an ad via the Ads service.

Creates callouts (уточнения), up to 25 characters each. Callouts are immutable — delete and recreate to change. Assign to ads via the Ads service.

Deletes callouts by id (adextensions/delete).

Reads virtual business cards (визитки) by id. The API requires ids — get them from ads' VCardId.

Creates a virtual business card in a campaign. vCards are immutable — delete and recreate to change.

Deletes vCards by id (vcards/delete).

Lists images in the ad image library, keyed by image hash. Upload new images with upload_ad_image.

Reads videos from the ad video library by id (the API requires ids). Uploads go via raw_request (advideos/add).

Lists creatives (smart banners, HTML5) from the creative library.

Uploads an image to the ad image library (adimages/add) and returns its AdImageHash — use that hash as AdImageHash on a text & image ad. Provide the image as a public URL (fetched and encoded server-side) or as base64 in imageData. Yandex accepts JPG/PNG/GIF up to 10 MB; a text & image ad needs a landscape image (min 1080×607).