Snapchat Public Data API
Retrieve a known public Snapchat Spotlight as a normalized record with available creator, caption, media, audio, timestamp, duration, and engagement fields.
Available Snapchat API
Use Snapchat Spotlight when you already have one public snapchat.com Spotlight URL and need its available details in a standard result shape.
What Snapchat data can you retrieve?
SocQ converts one known public Spotlight into a fixed ReelVideoItem record while preserving only fields available in the source response.
Spotlight identity and source
Keep the available item ID, original public URL, resource type, publication time, and collection time.
Caption and creator context
Return available text plus creator ID, username, display name, profile URL, avatar, verification, and privacy flags.
Video, audio, and taxonomy
Retain available media references, duration, audio metadata, shortcode, hashtags, and mentions in the normalized record.
Visible engagement
Capture available like, comment, share, play, and view counts as point-in-time public values.
SocQ vs Snapchat product tools
SocQ focuses on a supported public Spotlight detail lookup, while Snapchat's apps and creator or business tools serve authorized publishing, account, audience, and advertising workflows.
| Capability | SocQ | Snapchat product tools |
|---|---|---|
| Primary use | Retrieve one known public Spotlight detail | Create, publish, manage, analyze, or promote authorized content |
| Authentication | SocQ API key | Snapchat account, app, token, or product-specific authorization |
| Starting input | One public snapchat.com URL | Authorized account or product context |
| Publish or manage content | Not supported | Available in the applicable Snapchat product |
| Response shape | Normalized ReelVideoItem record | Product-specific Snapchat objects and interfaces |
How the Snapchat API works
Snapchat Spotlight uses an asynchronous task followed by stored-result retrieval.
1. Submit a public URL
Send one snapchat.com Spotlight URL and save the returned task_id.
2. Track the task
Poll /v1/tasks/{task_id} until processing succeeds or reports a failure.
3. Read the stored result
Read data.results.items and use next_cursor only if the shared task reader reports more stored records.
Authenticate with a SocQ API key and submit one public Spotlight URL.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-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.itemsCommon Snapchat API use cases
Selected-content research
Resolve a curated Spotlight URL into a traceable record for review and annotation.
Catalog enrichment
Add available creator, caption, media, audio, duration, taxonomy, and timestamp fields to an existing link collection.
Engagement snapshots
Compare visible metrics across separate collections while retaining collected_at as the observation time.
Limits and public-data policy
Snapchat Spotlight results are point-in-time public records and do not provide authorized Snapchat account operations.
- The payload accepts exactly one required url and rejects extra fields such as results_limit or callback_url.
- Validation accepts snapchat.com and its subdomains but does not enforce a pathname; use a public Spotlight link because unrelated paths can fail at the provider.
- The provider performs one detail lookup and returns at most one normalized item, not a Spotlight feed.
- Stored-result pagination belongs to the shared task reader and is not Snapchat source pagination.
- Optional caption, creator, media, publication, audio, duration, taxonomy, and metric fields can be null.
- The endpoint does not log in, publish, edit, delete, moderate, manage accounts, or operate advertising.
Snapchat API frequently asked questions
What does the Snapchat Spotlight API retrieve?
It retrieves one known public Spotlight and returns at most one normalized record with the source fields available at collection time.
Does the Snapchat API collect a Spotlight feed?
No. The current endpoint is a single-detail lookup and does not accept a profile, search term, cursor, or results_limit for source discovery.
Are the returned engagement counts real time?
No. Treat available counts as a public snapshot captured at collected_at, not as complete or continuously updated analytics.
Can SocQ publish to Snapchat?
No. This public-data endpoint does not provide login, publishing, account management, moderation, or advertising operations.
How is Snapchat Spotlight priced?
Each successful task costs a fixed 0.19 SocQ credits, regardless of returned field availability or result count.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Twitch API
Resolve a known public Twitch username into a normalized profile or collect its public video inventory for creator research, catalog enrichment, comparison, and snapshot monitoring.
Apple App Store API
Collect public Apple App Store app details, category rankings, and reviews from known store URLs as normalized app and review records.
SEO API
Query live Google organic results, compare keyword demand and ranking difficulty, expand seed terms, uncover the keywords and pages driving a site's search visibility, and classify search intent. Every endpoint uses the same SocQ API key, asynchronous task flow, and normalized result format.
Amazon API
Search public Amazon products and collect normalized product details, Best Sellers, reviews, and seller-profile records from supported marketplaces.
Douyin API
Retrieve public profiles and videos, search videos, collect one page of comments or creator videos, and inspect a known live room.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.