> For the complete documentation index, see [llms.txt](https://b2see.gitbook.io/b2see/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://b2see.gitbook.io/b2see/advertising-api.md).

# Advertising API

## Purpose

{% hint style="info" %}
Typically the Advertising API will be used by website agencies and classified portals to retrieve images and videos for displaying on a Vehicle Search Results and Detail web pages.
{% endhint %}

## Available Media Files

{% hint style="info" %}
Subject to individual account configurations, available for each vehicle are,

* Up to 50 jpg image URLs per vehicle
* 1 mp4 video as 
  * Video URL
  * Video embed HTML
  * YouTube embed URL
  * YouTube watch URL
  * YouTube embed HTML
    {% endhint %}

## Which Endpoint?

{% hint style="warning" %}
Very Important to choose the right endpoint for your use case.
{% endhint %}

{% tabs %}
{% tab title="/GetMedia" %}
Use this endpoint if you want to retrieve media for a single vehicle at a time. 

:thumbsup: Best for incremental updates
{% endtab %}

{% tab title="/GetMediaByDealer" %}
Use this endpoint if you want to retrieve all media for a single Dealer at a time. 
{% endtab %}

{% tab title="/GetMediaByGroup" %}
Use this endpoint if you want to retrieve all media for all locations for a Dealer Group at a time. 

:thumbsup: If there isn't a 1:1 relationship between locations in B2see and your system then this endpoint is best suited.

 :thumbsdown: If you would prefer the extra security of checking for by Dealer use /GetMediaByDealer or /GetMedia 
{% endtab %}
{% endtabs %}