Search Snapchat
Search public Snapchat content, returning Lens, Spotlight, topic, profile, publisher and place result sections with their source fields.
/v1/snapchat/searchx-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
Required search text; the response contains Snapchat's canonical query.
min 1 chars · max 50 chars
trail runningRequest correlation UUID.
Upstream request count, decoded response bytes and elapsed milliseconds.
Upstream HTTP attempts used by this request.
≥ 0
Decoded source response bytes.
≥ 0
Elapsed retrieval milliseconds.
≥ 0
True when usable Snapchat data is returned.
success or partial for usable data. Failure responses use failed or challenged.
one of: success, partial
Canonical Snapchat page or Spotlight URL.
absolute HTTPS URL
UTC retrieval timestamp.
Source, completeness and warnings for the returned public records.
public_page or public_comments.
one of: public_page, public_comments
Whether the selected source response was returned without a reported omission.
Warning codes describing omitted or additional records.
Returned record order, such as ranked or source_order.
one of: source_order, ranked
Required search text; the response contains Snapchat's canonical query.
Ordered source result sections, such as Spotlight, Lenses, profiles, publishers, places and episodes.
up to 100 items
Currently an empty object; Spotlight results are in the spotlight section.
Number of result objects returned across the sections.
≥ 0
Currently null.
Currently null.
Currently null.
Currently null.
No fields match.
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.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing, duplicate, unknown or malformed parameters. |
| 401 | unauthorized | Missing or invalid service API key. |
| 403 | restricted_page | The requested page reports restricted access. |
| 404 | not_found | The requested public record was not found. |
| 429 | upstream_rate_limited | Snapchat temporarily rate limited retrieval. |
| 502 | upstream_challenged | Snapchat challenged the request. |
| 502 | unsupported_page | The public source does not validate against the supported structure. |
| 502 | response_too_large payload_too_complex | The source exceeded byte or structural bounds. |
| 502 | unsafe_redirect request_limit upstream_error | Retrieval could not complete within its source and request bounds. |
| 503 | busy | The worker admission queue is full or its wait deadline was exceeded. |
| 504 | timeout | The request exceeded its deadline. |