EveryData platform API
Snapchat API
Use Snapchat for public Snapchat profiles, Stories, account posts, and Spotlight video details only through the 4 listed contracts, such as `profile`, `stories`, `user_posts`, because one view does not inherit another view’s reach.
For the selected public record, use Snapchat action `profile` with `username`; for public Story records, switch to `stories` and `username`, rather than carrying parameters across.
- Endpoint
- POST /api/v1/social
- Capabilities
- 4
- Per 1,000
- $1.389
Available capabilities
Compare the Snapchat actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
profileProfiles Retrieve public profile details from Snapchat. Accepts these parameters: | username | — | Sync delivery | — | $1.39 per 1,000 requests | business_profile_id · username · display_name · bio · profile_type · category · subcategory · subscriber_count · is_verified · website · address · has_story · lens_count · highlight_count · spotlight_count · url · avatar_url · snapcode_url · hero_image_url · created_at · platform |
storiesStories Retrieve public stories from Snapchat. Accepts these parameters: | username | — | Sync delivery | — | $1.39 per 1,000 requests | id · story_id · story_title · media_url · thumbnail_url · posted_at · username · author_name · author_url · platform |
user_postsPosts by user Retrieve public posts from Snapchat. Accepts these parameters: | username | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · summary · caption · media_url · thumbnail_url · duration_ms · width · height · view_count · share_count · comment_count · boost_count · recommend_count · posted_at · username · author_name · author_url · platform |
videoVideo details Retrieve a public video from Snapchat. Accepts these parameters: | url | spotlight_url | Sync delivery | — | $1.39 per 1,000 requests | id · url · text · hashtags · view_count · share_count · duration_ms · posted_at · thumbnail_url · media_url · username · author_name · author_url · author_avatar_url · platform |
What does each Snapchat action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Snapchat profile parameters mean?
Retrieve public profile details from Snapchat. Accepts these parameters: username. Returns these fields: lens_count, category, subcategory, and website.
usernameRequired- Specifies a public creator handle, accepted as a plain username (with optional
@prefix) or a full snapchat.com profile URL. This parameter retrieves public profile data forprofile, current public stories forstories, or Spotlight short videos foruser_posts. Private chats and friends-only stories are not accessible.Snapchat: Distinguishing Public Profiles, Business Profiles, and Snap StarsOfficial documentation distinguishes Public Profiles from personal accounts, noting that holding a Public Profile does not confer Business Profile or Snap Star status. This defines account types and eligibility boundaries without extending full web interface features to this endpoint.Checked
What do the Snapchat stories parameters mean?
Retrieve public stories from Snapchat. Accepts these parameters: username. Returns these fields: story_title, username, author_url, and posted_at.
usernameRequired- Specifies a public creator handle, accepted as a plain username (with optional
@prefix) or a full snapchat.com profile URL. This parameter retrieves public profile data forprofile, current public stories forstories, or Spotlight short videos foruser_posts. Private chats and friends-only stories are not accessible.Snapchat: Scope Boundaries for Public Stories vs. Friends-Only StoriesOfficial documentation clarifies that active Public Stories are accessible from public profile pages, whereas My Story · Friends is restricted to friends. EveryInfra covers only current public story scopes and does not commit to retrieving friends-only stories or expired historical assets.Checked
What do the Snapchat user_posts parameters mean?
Retrieve public posts from Snapchat. Accepts these parameters: username. Returns these fields: posted_at, summary, text, and duration_ms.
usernameRequired- Specifies a public creator handle, accepted as a plain username (with optional
@prefix) or a full snapchat.com profile URL. This parameter retrieves public profile data forprofile, current public stories forstories, or Spotlight short videos foruser_posts. Private chats and friends-only stories are not accessible.Snapchat: Spotlight as a Standalone Public Content HubOfficial documentation defines Spotlight as a central hub for discovering community Snaps, accessible via web viewing. This link defines content types without opening this endpoint to Spotlight searches, uploads, or full trend filtering.Checked
What do the Snapchat video parameters mean?
Retrieve a public video from Snapchat. Accepts these parameters: spotlight_url and url. Returns these fields: duration_ms, media_url, username, and author_avatar_url.
urlRequired- Specifies the exact Spotlight video URL required for the
videoaction. Dedicated video endpoints do not accept profile oradd/links as substitutes. On profile-oriented actions, full URLs serve only as a fallback input to parse the creator username.Snapchat Spotlight: Separating Total Views from Unique ViewersOfficial documentation distinguishes total play starts (Views) from unique Viewers, shares, and comments. The EveryInfra view_count parameter must not be redefined as unique viewer count; dashboard watch time, audience demographics, and extra metrics for authorized shares fall outside this endpoint's guarantees.Checked spotlight_urlOptional- Provides a secondary compatibility input for the
videoaction that takes lower precedence thanurl. Standard public video requests should populateurldirectly.
How to use the Snapchat API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"snapchat","action":"profile","params":{"username":"<username>"}}'
Snapchat API questions
What can I retrieve with the Snapchat API?
Set platform to snapchat. The current catalog lists profiles, stories, posts by user, and video details. These action names identify different Snapchat objects or views; they are not interchangeable search modes.
Which input starts a Snapchat `profile` request?
Specifies a public creator handle, accepted as a plain username (with optional @ prefix) or a full snapchat.com profile URL. This parameter retrieves public profile data for profile, current public stories for stories, or Spotlight short videos for user_posts. Private chats and friends-only stories are not accessible. Send it as username inside params.
Which fields can Snapchat `profile` return?
Its declared schema includes business_profile_id, username, display_name, and bio. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Snapchat action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.