Get Active Vendors

Get vendors that have at least one campaign created for the given DSP.

This endpoint returns a list of vendors that have at least one campaign created for the given DSP. The list is paginated and the next page token is returned in the response. The next page token can be used to get the next page of vendors.

GET /public/v1/offsite-ads/vendors/active

Get Active Vendors

cURL

curl --request GET \
  --url https://api.topsort.com/public/v1/offsite-ads/vendors/active \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.topsort.com/public/v1/offsite-ads/vendors/active"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.topsort.com/public/v1/offsite-ads/vendors/active', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.topsort.com/public/v1/offsite-ads/vendors/active",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.topsort.com/public/v1/offsite-ads/vendors/active"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.topsort.com/public/v1/offsite-ads/vendors/active")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.topsort.com/public/v1/offsite-ads/vendors/active")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "hasMore": true,
  "nextPage": "<string>",
  "vendors": [
    "<string>"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Autorisierungen

Authorization · string · header · erforderlich

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Abfrageparameter

dsp · enum<string> · erforderlich

The DSP to filter vendors by.

Verfügbare Optionen: google_ads, meta

Beispiele:

"google_ads"

"meta"

next_page · string | null

Pagination cursor as provided in an earlier response. If provided will fetch the next page of results.

limit · integer · Standard: 100

The pagination limit.

Erforderlicher Bereich: 0 <= x <= 365

Antwort

200

application/json

Successful Response

hasMore · boolean · erforderlich

Whether there are more active vendors

nextPage · string | null · erforderlich

The next page token

vendors · string[] · erforderlich

The active vendor ids for the DSP