snapchat/
spotlight-comments

The Snapchat Spotlight Comments API collects one source page of public comments for a Snapchat Spotlight URL, with normalized text, author, thread-reference, timestamp, and visible engagement fields.

Snapchat Spotlight Comments API

Spotlight URL input
One source page
Normalized comments
0.19 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Snapchat Spotlight Comments

Snapchat Spotlight comments are public responses associated with one specified Spotlight item. SocQ stores each returned response as a CommentItem with source identity, comment text, available author context, parent and post references, publication and collection times, and visible like or reply counts.

Snapchat Spotlight Comments API Features

  • One Spotlight URL per taskSubmit one non-empty url on snapchat.com or a Snapchat subdomain; the provider requests one source page for that target.
  • Normalized comment recordsThe Snapchat Spotlight Comments API returns comment IDs, text, source URLs, timestamps, and available author identity in the stable CommentItem 1.0 result shape.
  • Thread and engagement contextKeep parent_id, post_id, likes_count, and replies_count when the source exposes them, without treating missing fields as zero or complete thread coverage.

Snapchat Spotlight Comments API Parameters

ParametersRequiredDescription
urlRequiredRequired non-empty Snapchat URL. Runtime validation accepts snapchat.com and its subdomains; use a canonical public /@username/spotlight/{spotlight_id} URL so the provider receives the intended Spotlight resource.

How to Use the Snapchat Spotlight Comments API

Submit a public Spotlight URL to the Snapchat Spotlight Comments API, follow the asynchronous task, and read its stored normalized comments with task-result pagination.

  1. Copy the canonical public Snapchat Spotlight URL you want to inspect.
  2. POST url to /v1/snapchat/spotlight-comments and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
  4. Read data.results.items; if the stored task result spans API response pages, continue with next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Snapchat Spotlight Comments API Use Cases

  • Qualitative response review: Review returned public comment text and available author context for questions, reactions, and recurring themes around a selected Spotlight.
  • Source-linked comment archives: Preserve comment IDs, source URLs, post_id, parent_id, published_at, and collected_at so every stored response retains its available provenance.
  • Visible engagement snapshots: Compare available likes_count and replies_count across returned comments while anchoring each observation to collected_at.

Snapchat Spotlight Comments API Pro Tips

  • Use the canonical public /@username/spotlight/{spotlight_id} URL even though runtime validation checks the Snapchat host rather than enforcing that exact path.
  • Do not send cursor or results_limit in the submit payload; this endpoint owns only url and collects one provider page.
  • Treat parent_id and replies_count as available context, not proof that the returned records contain a complete reply tree.
  • Allow IDs, URLs, text, author fields, published_at, parent_id, post_id, and metrics to be null when the source does not provide them.
  • Keep provider collection depth separate from GET /v1/tasks/{task_id} pagination, whose cursor only pages through results already stored by the completed task.

Beyond the Snapchat Spotlight Comments API, use these APIs when you need a different type of public Snapchat data.

Explore other platforms

Combine Snapchat data with public data from other supported social platforms.

Snapchat Spotlight Comments API — FAQ

Snapchat Spotlight Comments API is a programmatic interface for collecting one source page of public comment records associated with a specified Snapchat Spotlight URL.

The submit contract accepts exactly one required url string. Runtime validation requires a snapchat.com host or subdomain; use the canonical public /@username/spotlight/{spotlight_id} form for the intended resource.

No. The submission contract has no results_limit or cursor field, and the provider integration makes one source request.

That cursor belongs to GET /v1/tasks/{task_id}. It paginates comment records already stored for a succeeded task, with a default response limit of 50 and an accepted range from 1 through 500; it does not fetch another Snapchat source page.

CommentItem 1.0 includes id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id, and metrics containing likes_count and replies_count. Nullable fields remain null when unavailable.

A successful Snapchat Spotlight Comments API task costs a fixed 0.19 SocQ credits, independent of the number of comments returned in that one source page.