Snapchat Snapcode and Public Page Extractor

Read public Snapchat Snapcode SVG endpoints and other public HTTP(S) pages, then return bounded normalized records. The default target is Snapchat's public Snapcode SVG endpoint.

Despite the historical scraper name, this Actor does not create or publish a separate binary PNG/SVG artifact. SVG responses are stored as bounded text inside the normalized record data. It does not log in, solve CAPTCHAs, bypass access controls, or access private data.

What it does

• accepts public HTTP(S) start URLs, including Snapcode SVG endpoints;
• uses one-attempt bounded HTTP with optional Apify proxying, response-size limits, timeouts, request delay, and concurrency controls;
• recognizes SVG Snapcode responses, JSON/JSON-LD arrays, visible HTML cards, and public page metadata;
• optionally follows same-host next links within maxPages;
• emits one stable normalized Snapcode or publicRecord row per unique record;
• keeps explicit diagnostics in OUTPUT when a page is unavailable, blocked, oversized, malformed, or has no recognizable record;
• writes OUTPUT_SUMMARY, compatibility OUTPUT, and SOURCE_METADATA artifacts.

Input

Field	Type	Default	Description
startUrls	array	Snapchat Snapcode SVG endpoint	Public HTTP(S) pages or endpoints, up to 100.
maxItems	integer	25	Maximum unique normalized records, from 1 to 100.
maxPages	integer	1	Maximum page requests including pagination, from 1 to 10.
followPagination	boolean	false	Follow same-host next links within maxPages.
requestDelayMs	integer	600	Delay before each request, from 0 to 30000 milliseconds.
maxConcurrency	integer	1	Concurrent requests, from 1 to 5.
timeoutSecs	integer	45	Per-request timeout, from 5 to 60 seconds.
maxResponseBytes	integer	5000000	Maximum response body retained in memory, from 100000 to 10000000 bytes.
proxyConfiguration	object	Direct connection	Optional Apify proxy configuration for public targets that require it.

Snapcode SVG example

{
  "startUrls": [
    {
      "url": "https://feelinsonice.appspot.com/web/deeplink/snapcode?username=snapchat&type=SVG"
    }
  ],
  "maxItems": 1,
  "maxPages": 1,
  "followPagination": false,
  "requestDelayMs": 600,
  "maxResponseBytes": 5000000
}

Public page example

{
  "startUrls": [{ "url": "https://www.snapchat.com/discover" }],
  "maxItems": 25,
  "maxPages": 1,
  "followPagination": false
}

Output

Normalized public rows use recordType Snapcode or publicRecord and stable recordId values. A Snapcode record preserves bounded SVG text inside data.

{
  "recordType": "Snapcode",
  "recordId": "public_record_…",
  "status": "success",
  "accessStatus": "SUCCESS",
  "found": true,
  "dataAvailable": true,
  "id": "source-identifier",
  "name": "Snapcode for snapchat",
  "url": "https://feelinsonice.appspot.com/web/deeplink/snapcode?username=snapchat&type=SVG",
  "sourceUrl": "https://feelinsonice.appspot.com/web/deeplink/snapcode?username=snapchat&type=SVG",
  "sourceDomain": "feelinsonice.appspot.com",
  "type": "Snapcode",
  "data": {
    "username": "snapchat",
    "format": "SVG",
    "svg": "<svg>...</svg>"
  },
  "sourceTransport": "direct HTTP"
}

Diagnostics are stored in OUTPUT rather than the dataset. They include code, message, target/source/HTTP details, request limits, and transport metadata. Common codes include HTTP_404, ACCESS_BLOCKED_HTTP_403, RESPONSE_TOO_LARGE, PAGE_PARSE_ERROR, and NO_PUBLIC_RECORDS.

Storage and local QA

• Dataset rows are written to {{links.apiDefaultDatasetUrl}}/items.
• OUTPUT_SUMMARY is the structured run summary; OUTPUT is a compatibility alias.
• SOURCE_METADATA records the public-only policy and confirms that authentication, private APIs, binary media downloads/storage, and CAPTCHA solving were not used.
• Local runs use storage/datasets/default/ and storage/key_value_stores/default/.
• npm test, npm run lint, npm audit --audit-level=high, apify validate-schema, and node validate-datasets.js cover the local contract.

Limits and reliability

Response bodies are bounded before parsing or storage. Redirects are safe-URL checked and capped at three hops; pagination is same-host and bounded by maxPages. Public page layouts, Snapcode endpoints, rate limits, and source fields can change, so a diagnostic is the expected result when a public record is not available.

Use this Actor only for lawful, authorized collection of public information. Respect Snapchat and source-site terms, privacy rights, rate limits, and applicable data-protection requirements.