List your Snapchat ads — creatives and ad types
snapchat-ads.adsList the ads in your Snapchat ad account with their creatives and types
- Price
- freeZum Listenpreis
- Success rate
- —Noch keine ErfolgsratendatenNoch keine Erfolgsratendaten
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/snapchat-ads.adsBeta- Uses platform quota
- Synchronous response
- Reads public data
Parameter
each ad carries a creative_id and a `type` (SNAP_AD | STORY | COLLECTION | DYNAMIC_SNAP_AD). The media itself is two hops away: GET /creatives/{id} gives the media id, GET /media/{id} the asset — the ad object holds no playable URL
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Pfadparameter | ||||
ad_account_id | Zeichenkette | Erforderlich | 8adc3db7-8148-4fbf-999c-8d2266369d74 | |
| Abfrageparameter | ||||
limit | Ganzzahl | Optional | 50 | |
cursor | Zeichenkette | Optional | ||
read_deleted_entities | Boolean | Optional | ||
- Pfadparameter
ad_account_idZeichenketteErforderlichBeispiel:
8adc3db7-8148-4fbf-999c-8d2266369d74- Abfrageparameter
limitGanzzahlOptionalBeispiel:
50cursorZeichenketteOptionalread_deleted_entitiesBooleanOptional
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
Beta
curl -X GET 'https://toolswitch.dev/v1/tools/snapchat-ads.ads' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/snapchat-ads.ads",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/snapchat-ads.ads", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Diese Gateway-API ist in der Beta; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit free einschließlich Servicegebühr abgerechnet.