Skip to main content

Send push notifications without your app, website, or notification infrastructure.

Project description

SPONTIT :vibration_mode:

Check out our complete API documentation at api.spontit.com. Our API repository is available here.

Send push notifications without your own app. :punch:

Using the Spontit API and Spontit app/webapp, you can send your own push notifications programmatically to Android, iOS, and Desktop devices. You can send your own in less than 5 minutes. :sunglasses: :trophy: (Without touching Swift, Objective-C, Java, XCode, Android Studio, the App Store approval process... :dizzy_face:).

This repository is the Python wrapper for our API. To see code snippets for several languages, see our documentation here.

RAPID START :running:

Spontit is 100% free! Please star the repo and rate/review the Spontit app in the App Store as well. Please invite a friend or two to Spontit!

  1. Sign up at spontit.com (you might need to click "Take me to the Desktop version"). Note down your username. It should be displayed on your profile once you are signed in.

  2. Get a secret key at spontit.com/secret_keys.

  3. Get the iPhone app or Android app. Sign in with the same account and allow notifications. See Step 11 to invite others.

  4. pip install spontit --upgrade && pip install requests

  5. from spontit import SpontitResource

  6. resource = SpontitResource(my_username, my_secret_key)

  7. response = resource.push("Hello!")

  8. Run the command help(SpontitResource) in Python for complete documentation.

  9. Or try an example! Check out the examples.

  10. You can customize the image of the notification on the website, iPhone app, or via the API by setting the image for the respective channel. See the image example titled create_new_channel_with_profile_image_and_push_to_it in the examples.

  11. To push to others, you can do two things.
    a) Have them sign up with a known email or phone number. Then push to them directly using their email or phone number. They do not have to follow you in order to receive the push. See simple_push_to_specific_phone_numbers_and_emails_example for an example (in the examples file).
    b) Have them follow the channel to which you will push (e.g. share spontit.com/my_username). You can see available invite options by calling print(resource.get_channel(...)) and supply the channel name. See the functions titled create_new_channel_and_get_invite_options and get_invite_options_for_my_main_account in the examples.

  12. Spontit is more than just broadcasting. You can send pushes to specific users and push personalized content. See how to do so at simple_push_to_specific_followers_example, simple_push_to_specific_phone_numbers_and_emails_example, and specific_followers_and_channel_example in the examples. You simply input a list of usernames and it will push to those users (provided they follow the specified channel) -- or input a list of phone numbers and emails (they do not have to follow the given channel; see part 11(a)). You can list the usernames of those who follow one of your specified channels. See an example of how to do so at list_followers_example and list_followers_for_channel_example in the examples.

  13. We are constantly working on expanding the functionality of Spontit. We GREATLY appreciate your input - feel free to add a feature request on our Github. :smiley:

Getting Started :white_check_mark:

Make an Account

First, go to spontit.com or download the Spontit app. Create an account and get your user ID. To see your user ID in the app, tap the "Profile" tab. To see your user ID on the website, look at the top of the screen.

You can change your user ID at any time here.

Generate a Secret Key

Once you have made an account, generate a secret key here. You might have to re-authenticate.

Push Notification UI Anatomy

You can change your user ID and display name at any time here.

Above we see a push notification sent to the main channel. Here, "Josh Wolff" is the display name of the user. The push message is the displayed text. The image shown is the personal profile picture of the user (see step 10 above). If the user opens the notification, they can open a link attached, if any, among other options (help(SpontitResource)). If they have an iPhone, they can like and comment on the notification.

Above we see a push notification to a channel (separate from the main channel). Josh owns this channel, but as you can see, it looks like its own account. "Dem 2020 Polls" is the channel name, the non-bold text is the message, and the image is the image set for the channel (see step 10 above). You can also change the push title with the pushTitle attribute.

Note on Our Development Priorities

We prioritize development of the iOS application over the website. If at any time, we describe a feature and it does not seem to be on the website, it might only exist in the iOS application. Please email us at info {at} spontit {dot} com so that we can clarify this to you and other developers. You are more than welcome to add a feature request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spontit-1.0.8.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

spontit-1.0.8-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

File details

Details for the file spontit-1.0.8.tar.gz.

File metadata

  • Download URL: spontit-1.0.8.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.5

File hashes

Hashes for spontit-1.0.8.tar.gz
Algorithm Hash digest
SHA256 0d2162fa76d9aae7c82e5859009edd2d350dd7415c06e791e636376b321f4321
MD5 ef228b183d77f7c71e24085d6e8c158b
BLAKE2b-256 0b5fa14795cf3c44bb573d8783088c9f0953cec7ba1408b20f29d5c3d3f29a63

See more details on using hashes here.

File details

Details for the file spontit-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: spontit-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 18.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.5

File hashes

Hashes for spontit-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 93492bc43f292d3f5a95e63a6aaf4d073568bfb7402358786734aca3247afd9a
MD5 3d0f57dec0ad727ff17291ae81f1255b
BLAKE2b-256 f371a4b57f82966ebdee400c63ad3e2a38c1268261fa365df99bfaff5cf6c3a9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page