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.