Snap

One Spotlight video's full record — creator, duration, view, share and comment counts.

POST /api/public/v1/scrape/snapchat/snap

Returns post_detail_api

Parameters#

snap_id string required

The id from /spotlight/<id>, as returned by the `spotlight` endpoint.

Example: W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ

Results#

GET /runs/:id/results answers with this once the run has finished — one post per row.

Every row also carries raw_json — the platform's own object for that row, exactly as it arrived, with nothing removed. It is left out of the example for length.

This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.

curl -X POST https://socialholmes.com/api/public/v1/scrape/snapchat/snap \
  -H "Authorization: Bearer $SOCIALHOLMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"snap_id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ"}}'

import os
import requests

run = requests.post(
    "https://socialholmes.com/api/public/v1/scrape/snapchat/snap",
    headers={"Authorization": f"Bearer {os.environ['SOCIALHOLMES_KEY']}"},
    json={"parameters": {"snap_id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ"}},
).json()

print(run["id"], run["status"])

const response = await fetch("https://socialholmes.com/api/public/v1/scrape/snapchat/snap", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { snap_id: "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ" } }),
})

const run = await response.json()
console.log(run.id, run.status)

require "net/http"
require "json"

response = Net::HTTP.post(
  URI("https://socialholmes.com/api/public/v1/scrape/snapchat/snap"),
  { parameters: { snap_id: "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ" } }.to_json,
  "Authorization" => "Bearer #{ENV.fetch('SOCIALHOLMES_KEY')}",
  "Content-Type" => "application/json"
)

run = JSON.parse(response.body)
puts run["id"], run["status"]

<?php

$ch = curl_init("https://socialholmes.com/api/public/v1/scrape/snapchat/snap");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SOCIALHOLMES_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["parameters" => ["snap_id" => "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ"]]),
]);

$run = json_decode(curl_exec($ch), true);

echo $run["id"], " ", $run["status"];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"parameters": map[string]string{"snap_id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ"},
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/snapchat/snap", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SOCIALHOLMES_KEY"))
	req.Header.Set("Content-Type", "application/json")

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

	var run map[string]any
	json.NewDecoder(res.Body).Decode(&run)

	fmt.Println(run["id"], run["status"])
}

202 Accepted

{
  "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
  "status": "queued",
  "platform": "snapchat",
  "endpoint": "snap",
  "target": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
  "url": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
  "result_count": 0,
  "created_at": "2026-08-28T16:18:50Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "snapchat",
    "endpoint": "snap",
    "target": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
    "url": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
    "result_count": 1,
    "estimated_cost": 10,
    "captures": 1,
    "created_at": "2026-08-22T09:11:03Z",
    "started_at": "2026-08-22T09:12:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "post",
  "results": [
    {
      "media_type_id": "VIDEO",
      "taken_at": "2026-08-22T09:13:20Z",
      "media_urls": [
        "https://snapchat.example/media/spotlight_rollout.mp4"
      ],
      "id": "W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
      "url": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYeG9xcGd0ZWd3AZ14BVv0AZ14BQkrAAAAAQ",
      "story_type": "SPOTLIGHT_HIGHLIGHT",
      "title": "Rollout, start to finish",
      "generated_title": "Rocket rollout at sunrise",
      "caption": "The full rollout to Launch Complex 39B.",
      "hashtags": [
        "artemis"
      ],
      "duration_ms": 58000,
      "width": 1080,
      "height": 1920,
      "thumbnail_url": "https://snapchat.example/img/spotlight_rollout.jpg",
      "view_count": 4820113,
      "share_count": 21877,
      "comment_count": 8104,
      "boost_count": 44210,
      "author": {
        "username": "nasa",
        "url": "https://www.snapchat.com/@nasa"
      }
    }
  ],
  "page": {
    "limit": 1,
    "offset": 0,
    "returned": 1,
    "total": 1
  }
}

Try it