Skip to content
scrapeatlas.Dashboard

Search Snapchat

Try in Playground

Search public Snapchat content, returning Lens, Spotlight, topic, profile, publisher and place result sections with their source fields.

GET/v1/snapchat/searchx-api-key
x-api-keystringrequiredheader

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

Query parameters
1
querystringrequiredquery

Required search text; the response contains Snapchat's canonical query.

min 1 chars · max 50 chars

Exampletrail running
Response fields
22
requestIdstring

Request correlation UUID.

Upstream request count, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Upstream HTTP attempts used by this request.

≥ 0

accounting.responseBytesinteger

Decoded source response bytes.

≥ 0

accounting.durationMsnumber

Elapsed retrieval milliseconds.

≥ 0

successboolean

True when usable Snapchat data is returned.

statusenum

success or partial for usable data. Failure responses use failed or challenged.

one of: success, partial

sourceUrlstring

Canonical Snapchat page or Spotlight URL.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Source, completeness and warnings for the returned public records.

coverage.sourceenum

public_page or public_comments.

one of: public_page, public_comments

coverage.completeboolean

Whether the selected source response was returned without a reported omission.

coverage.warningsstring[]

Warning codes describing omitted or additional records.

coverage.orderenumoptional

Returned record order, such as ranked or source_order.

one of: source_order, ranked

querystring

Required search text; the response contains Snapchat's canonical query.

sectionsobject[]

Ordered source result sections, such as Spotlight, Lenses, profiles, publishers, places and episodes.

up to 100 items

spotlightCardMapobject

Currently an empty object; Spotlight results are in the spotlight section.

countinteger

Number of result objects returned across the sections.

≥ 0

localestringnullable

Currently null.

countrystringnullable

Currently null.

pageMetadataobjectnullable

Currently null.

deepLinkPathstringnullable

Currently null.

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
11
HTTPfailure.codeMeaning
400invalid_requestMissing, duplicate, unknown or malformed parameters.
401unauthorizedMissing or invalid service API key.
403restricted_pageThe requested page reports restricted access.
404not_foundThe requested public record was not found.
429upstream_rate_limitedSnapchat temporarily rate limited retrieval.
502upstream_challengedSnapchat challenged the request.
502unsupported_pageThe public source does not validate against the supported structure.
502response_too_large payload_too_complexThe source exceeded byte or structural bounds.
502unsafe_redirect request_limit upstream_errorRetrieval could not complete within its source and request bounds.
503busyThe worker admission queue is full or its wait deadline was exceeded.
504timeoutThe request exceeded its deadline.