E-commerce integration with Avito API

Integration of Online Store with Avito (API)

Avito is Russia's largest classifieds board. API is available for pro accounts and allows automatically placing and updating listings, managing prices, and receiving messages from buyers.

Authentication

Avito uses OAuth2 with client_credentials:

class AvitoClient
{
    private string $accessToken;

    public function authenticate(): void
    {
        $resp = Http::post('https://api.avito.ru/token', [
            'client_id'     => config('services.avito.client_id'),
            'client_secret' => config('services.avito.client_secret'),
            'grant_type'    => 'client_credentials',
        ]);

        $this->accessToken = $resp->json('access_token');
    }

    private function request(string $method, string $path, array $data = []): array
    {
        return Http::withToken($this->accessToken)
            ->{strtolower($method)}("https://api.avito.ru{$path}", $data)
            ->json();
    }
}

Placing a Listing

public function createListing(Product $product): int
{
    $resp = $this->request('POST', '/core/v1/accounts/{user_id}/items', [
        'ad' => [
            'category' => ['id' => $this->getCategoryId($product)],
            'title'    => $product->name,
            'description' => $product->description,
            'price'    => $product->price,
            'images'   => $product->images->pluck('url')->map(fn($url) => ['url' => $url])->all(),
            'contacts' => [
                'phone_number' => config('services.avito.phone'),
            ],
            'location' => ['id' => config('services.avito.city_id')],
        ]
    ]);

    return $resp['id'];
}

XML Feed (Alternative Method)

For bulk placement, Avito accepts XML feed by URL:

<?xml version="1.0" encoding="UTF-8"?>
<Ads formatVersion="3">
  <Ad>
    <Id>product-123</Id>
    <Title>iPhone 15 Pro 256GB</Title>
    <Category>Phones</Category>
    <Price>89990</Price>
    <Description>New, 1 year warranty</Description>
    <Images>
      <Image url="https://example.com/images/iphone.jpg"/>
    </Images>
    <Condition>New</Condition>
  </Ad>
</Ads>

XML feed is simpler for initial setup and bulk placement. Updated by schedule (every 24 hours).

Timeline

XML feed with auto-generation: 2–3 days. Full API integration: 5–7 business days.