Get a VSCO image

Try in Playground

Retrieve one VSCO image by URL or ID with caption, dimensions, capture and upload dates, camera metadata, preset, hashtags and owner.

GET/v1/vsco/mediax-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringquery

Image URL in the form https://vsco.co/<username>/media/<id>. Provide url or id, not both.

max 1024 chars

Examplehttps://vsco.co/example-photographer/media/65a1b2c3d4e5f60718293a4b

idstringquery

VSCO image ID (24 lowercase hexadecimal characters). Provide url or id, not both.

max 24 chars

Response fields

successboolean

True when usable data is returned; inspect status and coverage.

statusenum

success or partial for usable data; failed or challenged for a failure.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Public vsco.co page the data describes.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Returned-page coverage and mapping warnings.

coverage.sourcestring

VSCO's public web API.

coverage.completeboolean

Whether every supported field on this page was mapped without a reported omission.

coverage.warningsenum[]

Named warnings: unknown_media_type, unknown_block_type, invalid_item, record_limit, block_limit, total_unavailable (no collection or search count) or pagination_unavailable (no next-page signal or cursor).

Retrieval attempt, source byte and timing measurements.

accounting.upstreamRequestsinteger

Upstream request attempts, including the token page read and any retry.

≥ 0

accounting.responseBytesinteger

Decoded source bytes read during this request.

≥ 0

accounting.durationMsnumber

Elapsed operation time in milliseconds.

≥ 0

Image or video record.

media.idstring

VSCO media ID (24 hexadecimal characters for images).

media.mediaTypestring

image, video, or the source type for other media.

media.descriptionstringnullable

Caption with hashtags, or null when empty.

media.widthintegernullable

Width in pixels, or null.

≥ 0

media.heightintegernullable

Height in pixels, or null.

≥ 0

media.imageUrlstringnullable

HTTPS image URL, or null for videos.

absolute HTTPS URL

media.permalinkstringnullable

Canonical https://vsco.co/<username>/media/<id> link without share tracking, or null.

absolute HTTPS URL

media.isVideoboolean

Whether VSCO marks the record as a video.

media.captureDatestringnullable

Capture time as an ISO 8601 timestamp, or null.

media.uploadDatestringnullable

Upload time as an ISO 8601 timestamp, or null.

Published camera metadata, or null.

media.camera.makestringnullable

Camera make, or null.

media.camera.modelstringnullable

Camera model, or null.

media.camera.isonumbernullable

ISO value, or null.

media.camera.aperturenumbernullable

Aperture f-number, or null.

media.camera.shutterSpeedstringnullable

Shutter speed as published, for example 1/250, or null.

media.camera.whiteBalancestringnullable

White balance, or null.

media.camera.flashModestringnullable

Flash mode, or null.

media.camera.softwarestringnullable

Editing software, or null.

VSCO preset used for the edit, or null.

media.preset.keystring

Preset key.

media.preset.shortNamestringnullable

Preset display name, or null.

Hashtags in source order.

up to 100 items

media.tags.textstring

Always included.

media.tags.slugstring

Always included.

Video playback details for video records, otherwise null.

media.video.playbackUrlstringnullable

HLS playback URL, or null.

absolute HTTPS URL

media.video.posterUrlstringnullable

Poster image URL, or null.

absolute HTTPS URL

media.video.durationSecnumbernullable

Duration in seconds, or null.

≥ 0

media.video.hasAudiobooleannullable

Whether the video has audio, or null.

Account that published the image.

media.owner.usernamestringnullable

VSCO username of the owner, or null.

media.owner.namestringnullable

Owner display name, or null when blank.

media.owner.siteIdintegernullable

Numeric VSCO site ID, or null.

≥ 0

media.owner.userIdintegernullable

Numeric VSCO user ID, or null.

≥ 0

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with named media-type, block-type, invalid-item, record-limit, total or pagination warnings.
400	`invalid_request`	Missing, duplicate, malformed, unsafe or unsupported parameters.
401	`unauthorized`	Missing or invalid worker API key.
404	`not_found`	The requested VSCO profile or image was not found.
422	`restricted_page`	VSCO refused anonymous access to the requested resource.
422	`unsupported_page`	The VSCO response structure or identity could not be mapped.
502	`upstream_challenged`	VSCO challenged retrieval.
502	`upstream_rate_limited`	VSCO rate-limited retrieval.
502	`upstream_error`	Source retrieval did not complete.
502	`response_too_large`	Decoded source bytes exceeded the request limit.
502	`unsafe_redirect`	VSCO answered with a redirect, which is never followed.
502	`request_limit`	The upstream request budget was exhausted.
503	`busy`	Worker request or queue capacity was exceeded.
504	`timeout`	The operation deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/vsco/media?url=https%3A%2F%2Fvsco.co%2Fexample-photographer%2Fmedia%2F65a1b2c3d4e5f60718293a4b" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vsco/media?url=https%3A%2F%2Fvsco.co%2Fexample-photographer%2Fmedia%2F65a1b2c3d4e5f60718293a4b",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vsco/media?url=https%3A%2F%2Fvsco.co%2Fexample-photographer%2Fmedia%2F65a1b2c3d4e5f60718293a4b",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`VSCO request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/vsco/media",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://vsco.co/example-photographer/media/65a1b2c3d4e5f60718293a4b"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

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

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/vsco/media?url=https%3A%2F%2Fvsco.co%2Fexample-photographer%2Fmedia%2F65a1b2c3d4e5f60718293a4b", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/vsco/media?url=https%3A%2F%2Fvsco.co%2Fexample-photographer%2Fmedia%2F65a1b2c3d4e5f60718293a4b"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://vsco.co/example-photographer/media/65a1b2c3d4e5f60718293a4b",
  "fetchedAt": "2026-11-07T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 9000,
    "durationMs": 420
  },
  "media": {
    "id": "65a1b2c3d4e5f60718293a4b",
    "mediaType": "image",
    "description": "Morning light on the coast #film",
    "width": 2048,
    "height": 1365,
    "imageUrl": "https://im.vsco.co/aws-us-west-2/000000/100001/65a1b2c3d4e5f60718293a4b/example.jpg",
    "permalink": "https://vsco.co/example-photographer/media/65a1b2c3d4e5f60718293a4b",
    "isVideo": false,
    "captureDate": "2026-10-30T07:12:00.000Z",
    "uploadDate": "2026-11-01T18:40:00.000Z",
    "camera": {
      "make": "FUJIFILM",
      "model": "X-T5",
      "iso": 200,
      "aperture": 5.6,
      "shutterSpeed": "1/250",
      "whiteBalance": "Auto",
      "flashMode": "No Flash",
      "software": "VSCO"
    },
    "preset": {
      "key": "a6",
      "shortName": "A6"
    },
    "tags": [
      {
        "text": "#film",
        "slug": "film"
      }
    ],
    "video": null,
    "owner": {
      "username": "example-photographer",
      "name": "Example Photographer",
      "siteId": 100001,
      "userId": 200001
    }
  }
}

Missing, duplicate, malformed, unsafe or unsupported parameters.

{
  "success": false,
  "status": "failed",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}