---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/start.md
  - https://yandex.ru/dev/direct/doc/ru/start.md
  - href: en/start.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/start/start.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/en/llms.txt

# How to get started with the API: Tutorial

In this tutorial, you will learn how to work with Yandex Direct API, even if you start from scratch. You will step through all the preliminary steps: get access to the API and configure Sandbox. You will get familiar with the features of Yandex Direct API, details of its structure and basic request parameters. Also, you will see many examples  you can implement in your programming language or using the cURL utility.

## [Lesson 1. What is Yandex Direct API](https://yandex.ru/dev/direct/doc/en/intro.md#intro)

In this lesson, we will explain why Yandex Direct needs an API, and introduce you to the basics of its operation.

## [Lesson 2. API access: How to register an app in Yandex OAuth](https://yandex.ru/dev/direct/doc/en/register.md#register)

In this lesson, you will learn about the first step of getting access to Yandex Direct API for your app: registering your app in Yandex OAuth.

## [Lesson 3. API access: How to submit a request](https://yandex.ru/dev/direct/doc/en/access-request.md#access-request)

In this lesson, we are going to discuss the second step of enabling your app with access to Yandex Direct API: submitting a request.

## [Lesson 4. How to get an OAuth token](https://yandex.ru/dev/direct/doc/en/token.md#token)

In this lesson, you will learn more about OAuth tokens, how to get them and use them.

## [Lesson 5. How to enable Sandbox](https://yandex.ru/dev/direct/doc/en/sandbox.md#sandbox)

In this lesson, you will learn how to use the Yandex Direct API without accidentally launching a live campaign or spending a real budget.

## [Lesson 6. How to make an API request](https://yandex.ru/dev/direct/doc/en/format.md#format)

In this lesson, you will see formats of interaction with the Yandex Direct API and learn how to make your first request.

## [Lesson 7. How to get data via the API](https://yandex.ru/dev/direct/doc/en/get.md#get)

In this lesson, you will learn about the API structure and look at some examples of getting data.

## [Lesson 8. How to make changes via the API](https://yandex.ru/dev/direct/doc/en/modify.md#modify)

In this lesson you will learn how to edit data using the API.

## [Lesson 9. How to go live with your app](https://yandex.ru/dev/direct/doc/en/real-world.md#real-world)

In this lesson, you will learn what you need to do to ensure that your app can run not just in Sandbox, but with real Yandex Direct user data.

## [Lesson 10. How to use the API efficiently: Restrictions and recommendations](https://yandex.ru/dev/direct/doc/en/optimize.md#optimize)

In this lesson, you will learn what restrictions can be applied in the Yandex Direct API and how you can run your app efficiently in view of those restrictions.