Skip to docs content
Browse and search
On this page

Add watched Instagram accounts

Add up to 100 Instagram accounts to your watchlist. Accounts already on it are reported as duplicate and count as success.

POST/api/instagram/add-account

Authorization

  • AuthorizationstringheaderrequiredBearer authentication with your TweetStream API key: Bearer <key>.

Body

  • accountsstring | string[]requiredInstagram usernames, with or without a leading @.

Response fields

  • accountsobject[]required
    • usernamestringrequired
    • stateenum<string>requiredlive: watched now. pending: added, and watching starts shortly. paused: over your current limit, so not watched.
    • createdAtstringrequired
  • limitintegerrequired
  • rejectedobject[]required
    • usernamestringrequired
    • reasonenum<string>required

Responses

  • 200Success
  • 207Some requested accounts were changed and some were rejected
  • 400Invalid request, or every requested account was rejected
  • 401Missing or invalid API key
  • 403The authenticated account cannot use this capability
  • 500The request could not be completed
  • 503Instagram account management is temporarily unavailable