swagger: '2.0'
schemes:
  - https
host: api.instagram.com
basePath: /v1
info:
  contact:
    name: Instagram
    url: 'https://instagram.com/developer/support'
  description: |
    Description of Instagram RESTful API.

    Current limitations:
      * Instagram service does not support [cross origin headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS)
      for security reasons, therefore it is not possible to use Swagger UI and make API calls directly from browser.
      * Modification API requests (`POST`, `DELETE`) require additional security [scopes](https://instagram.com/developer/authorization/)
      that are available for Apps [created on or after Nov 17, 2015](http://instagram.com/developer/review/) and
      started in [Sandbox Mode](http://instagram.com/developer/sandbox/).
      * Consider the [Instagram limitations](https://instagram.com/developer/limits/) for API calls that depends on App Mode.

    **Warning:** For Apps [created on or after Nov 17, 2015](http://instagram.com/developer/changelog/) API responses
    containing media objects no longer return the `data` field in `comments` and `likes` nodes.

    Last update: 2015-11-28
  termsOfService: 'https://instagram.com/about/legal/terms/api/'
  title: Instagram
  version: 1.0.0
  x-apisguru-categories:
    - social
    - media
  x-logo:
    url: 'https://instagramstatic-a.akamaihd.net/bluebar/8a8f88c/images/press/brand-thumb-icon.jpg'
  x-origin:
    - format: swagger
      url: 'https://raw.githubusercontent.com/darklynx/swagger-api-collection/master/api/yaml/instagram.yaml'
      version: '2.0'
  x-providerName: instagram.com
  x-unofficialSpec: true
externalDocs:
  description: Instagram Developer Documentation
  url: 'https://instagram.com/developer'
produces:
  - application/json
securityDefinitions:
  api_key:
    in: query
    name: access_token
    type: apiKey
  instagram_auth:
    authorizationUrl: 'https://instagram.com/oauth/authorize/'
    flow: implicit
    scopes:
      basic: to read a user's profile info and media (granted by default)
      comments: to post and delete comments on a user's behalf
      follower_list: to read the list of followers and followed-by users
      likes: to like and unlike media on a user's behalf
      public_content: to read any public profile info and media on a user’s behalf
      relationships: to follow and unfollow accounts on a user's behalf
    type: oauth2
tags:
  - description: Get information about users
    name: users
  - description: Relationships to other users outgoing and incoming
    name: relationships
  - description: Get information about media
    name: media
  - description: Manage comments
    name: comments
  - description: Manage likes
    name: likes
  - description: Get information about tags
    name: tags
  - description: Get information about locations
    name: locations
  - description: Get geographies
    name: geographies
paths:
  '/geographies/{geo-id}/media/recent':
    get:
      deprecated: true
      description: |
        Get recent media from a geography subscription that you created.

        **Note:** You can only access Geographies that were explicitly created by your OAuth client. Check the
        Geography Subscriptions section of the [real-time updates page](https://instagram.com/developer/realtime/).
        When you create a subscription to some geography that you define, you will be returned a unique `geo-id` that
        can be used in this query. To backfill photos from the location covered by this geography, use the
        [media search endpoint](https://instagram.com/developer/endpoints/media/).

        **Warning:** [Deprecated](http://instagram.com/developer/changelog/) for Apps created **on or after** Nov 17, 2015
      parameters:
        - description: The geography ID.
          in: path
          name: geo-id
          required: true
          type: string
        - description: Max number of media to return.
          format: int32
          in: query
          name: count
          required: false
          type: integer
        - description: Return media before this `min_id`.
          in: query
          name: min_id
          required: false
          type: string
      responses:
        '200':
          description: List of recent media entries from a geography subscription.
          schema:
            $ref: '#/definitions/MediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
      summary: Get recent media from a custom geo-id.
      tags:
        - geographies
  /locations/search:
    get:
      description: Search for a location by geographic coordinate.
      parameters:
        - description: 'Default is 1000m (distance=1000), max distance is 5000.'
          format: int32
          in: query
          name: distance
          required: false
          type: integer
        - description: 'Returns a location mapped off of a Facebook places id. If used, a Foursquare id and `lat`, `lng` are not required.'
          in: query
          name: facebook_places_id
          required: false
          type: string
        - description: |
            Returns a location mapped off of a foursquare v1 api location id. If used, you are not required to use
            `lat` and `lng`. Note that this method is deprecated; you should use the new foursquare IDs with V2 of their API.
          in: query
          name: foursquare_id
          required: false
          type: string
        - description: 'Latitude of the center search coordinate. If used, `lng` is required.'
          format: double
          in: query
          name: lat
          required: false
          type: number
        - description: 'Longitude of the center search coordinate. If used, `lat` is required.'
          format: double
          in: query
          name: lng
          required: false
          type: number
        - description: |
            Returns a location mapped off of a foursquare v2 api location id. If used, you are not required to use
            `lat` and `lng`.
          in: query
          name: foursquare_v2_id
          required: false
          type: string
      responses:
        '200':
          description: List of found locations.
          schema:
            $ref: '#/definitions/LocationSearchResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Search for a location by geographic coordinate.
      tags:
        - locations
  '/locations/{location-id}':
    get:
      description: Get information about a location.
      parameters:
        - description: The location ID.
          in: path
          name: location-id
          required: true
          type: string
      responses:
        '200':
          description: Location information response.
          schema:
            $ref: '#/definitions/LocationInfoResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Get information about a location.
      tags:
        - locations
  '/locations/{location-id}/media/recent':
    get:
      description: Get a list of recent media objects from a given location.
      parameters:
        - description: The location ID.
          in: path
          name: location-id
          required: true
          type: string
        - description: Return media after this UNIX timestamp.
          format: int64
          in: query
          name: min_timestamp
          required: false
          type: integer
        - description: Return media before this UNIX timestamp.
          format: int64
          in: query
          name: max_timestamp
          required: false
          type: integer
        - description: Return media before this `min_id`.
          in: query
          name: min_id
          required: false
          type: string
        - description: Return media after this `max_id`.
          in: query
          name: max_id
          required: false
          type: string
      responses:
        '200':
          description: List of media entries from this location.
          schema:
            $ref: '#/definitions/MediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Get a list of recent media objects from a given location.
      tags:
        - locations
  /media/popular:
    get:
      deprecated: true
      description: |
        Get a list of what media is most popular at the moment. Can return mix of `image` and `video` types.

        **Warning:** [Deprecated](http://instagram.com/developer/changelog/) for Apps created **on or after** Nov 17, 2015
      responses:
        '200':
          description: Found media resources (without likes information).
          schema:
            $ref: '#/definitions/MediaSearchResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
      summary: Get a list of currently popular media.
      tags:
        - media
  /media/search:
    get:
      description: |
        Search for media in a given area. The default time span is set to 5 days. The time span must not exceed 7 days.
        Defaults time stamps cover the last 5 days. Can return mix of `image` and `video` types.
      parameters:
        - description: 'Latitude of the center search coordinate. If used, `lng` is required.'
          format: double
          in: query
          name: lat
          required: true
          type: number
        - description: 'Longitude of the center search coordinate. If used, `lat` is required.'
          format: double
          in: query
          name: lng
          required: true
          type: number
        - description: A unix timestamp. All media returned will be taken later than this timestamp.
          format: int64
          in: query
          name: min_timestamp
          required: false
          type: integer
        - description: A unix timestamp. All media returned will be taken earlier than this timestamp.
          format: int64
          in: query
          name: max_timestamp
          required: false
          type: integer
        - description: 'Default is 1km (distance=1000), max distance is 5km.'
          format: int32
          in: query
          name: distance
          required: false
          type: integer
      responses:
        '200':
          description: Found media resources (without likes information) in a given area.
          schema:
            $ref: '#/definitions/MediaSearchResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Search for media in a given area.
      tags:
        - media
  '/media/shortcode/{shortcode}':
    get:
      description: |
        This endpoint returns the same response as `GET /media/{media-id}`.

        A media object's shortcode can be found in its shortlink URL. An example shortlink is
        `http://instagram.com/p/D/`, its corresponding shortcode is `D`.
      parameters:
        - description: The short code of the media resource.
          in: path
          name: shortcode
          required: true
          type: string
      responses:
        '200':
          description: Media resource information.
          schema:
            $ref: '#/definitions/MediaEntryResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get information about a media object.
      tags:
        - media
  '/media/{media-id}':
    get:
      description: |
        Get information about a media object. The returned type key will allow you to differentiate between image and
        video media.

        **Note:** if you authenticate with an OAuth Token, you will receive the user_has_liked key which quickly tells
        you whether the current user has liked this media item.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
      responses:
        '200':
          description: Media resource information.
          schema:
            $ref: '#/definitions/MediaEntryResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get information about a media object.
      tags:
        - media
  '/media/{media-id}/comments':
    get:
      description: Get a list of recent comments on a media object.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
      responses:
        '200':
          description: List of comments of the media resource.
          schema:
            $ref: '#/definitions/CommentsResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get a list of recent comments on a media object.
      tags:
        - comments
    post:
      description: |
        Create a comment on a media object with the following rules:

          * The total length of the comment cannot exceed 300 characters.
          * The comment cannot contain more than 4 hashtags.
          * The comment cannot contain more than 1 URL.
          * The comment cannot consist of all capital letters.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
        - description: Text to post as a comment on the media object as specified in `media-id`.
          in: query
          name: text
          required: true
          type: string
      responses:
        '200':
          description: Result of posting a comment.
          schema:
            $ref: '#/definitions/StatusResponse'
      security:
        - api_key: []
        - instagram_auth:
            - comments
      summary: Create a comment on a media object.
      tags:
        - comments
  '/media/{media-id}/comments/{comment-id}':
    delete:
      description: |
        Remove a comment either on the authenticated user's media object or authored by the authenticated user.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
        - description: The ID of the comment entry.
          in: path
          name: comment-id
          required: true
          type: string
      responses:
        '200':
          description: Result of deleting a comment.
          schema:
            $ref: '#/definitions/StatusResponse'
      security:
        - api_key: []
        - instagram_auth:
            - comments
      summary: Remove a comment.
      tags:
        - comments
  '/media/{media-id}/likes':
    delete:
      description: Remove a like on this media by the currently authenticated user.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
      responses:
        '200':
          description: Result of removing a like.
          schema:
            $ref: '#/definitions/StatusResponse'
      security:
        - api_key: []
        - instagram_auth:
            - likes
      summary: Remove a like on this media by the current user.
      tags:
        - likes
    get:
      description: Get a list of users who have liked this media.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
      responses:
        '200':
          description: List of users who liked the media resource.
          schema:
            $ref: '#/definitions/UsersInfoResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get a list of users who have liked this media.
      tags:
        - likes
    post:
      description: Set a like on this media by the currently authenticated user.
      parameters:
        - description: The ID of the media resource.
          in: path
          name: media-id
          required: true
          type: string
      responses:
        '200':
          description: Result of setting a like.
          schema:
            $ref: '#/definitions/StatusResponse'
      security:
        - api_key: []
        - instagram_auth:
            - likes
      summary: Set a like on this media by the current user.
      tags:
        - likes
  /tags/search:
    get:
      description: Search for tags by name.
      parameters:
        - description: 'A valid tag name without a leading \#. (eg. snowy, nofilter)'
          in: query
          name: q
          required: true
          type: string
      responses:
        '200':
          description: List of found tags and their statistics.
          schema:
            $ref: '#/definitions/TagSearchResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Search for tags by name.
      tags:
        - tags
  '/tags/{tag-name}':
    get:
      description: Get information about a tag object.
      parameters:
        - description: The tag name.
          in: path
          name: tag-name
          required: true
          type: string
      responses:
        '200':
          description: Tag information response.
          schema:
            $ref: '#/definitions/TagInfoResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Get information about a tag object.
      tags:
        - tags
  '/tags/{tag-name}/media/recent':
    get:
      description: |
        Get a list of recently tagged media. Use the `max_tag_id` and `min_tag_id` parameters in the pagination
        response to paginate through these objects.
      parameters:
        - description: The tag name.
          in: path
          name: tag-name
          required: true
          type: string
        - description: Count of tagged media to return.
          in: query
          name: count
          required: false
          type: integer
        - description: Return media before this `min_tag_id`.
          in: query
          name: min_tag_id
          required: false
          type: string
        - description: Return media after this `max_tag_id`.
          in: query
          name: max_tag_id
          required: false
          type: string
      responses:
        '200':
          description: List of media entries with this tag.
          schema:
            $ref: '#/definitions/TagMediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - public_content
      summary: Get a list of recently tagged media.
      tags:
        - tags
  /users/search:
    get:
      description: Search for a user by name.
      parameters:
        - description: A query string.
          in: query
          name: q
          required: true
          type: string
        - description: Number of users to return.
          in: query
          name: count
          required: false
          type: integer
      responses:
        '200':
          description: List of found users.
          schema:
            $ref: '#/definitions/UsersInfoResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
      summary: Search for a user by name.
      tags:
        - users
  /users/self/feed:
    get:
      deprecated: true
      description: |
        See the authenticated user's feed.

        **Warning:** [Deprecated](http://instagram.com/developer/changelog/) for Apps created **on or after** Nov 17, 2015
      parameters:
        - description: Count of media to return.
          in: query
          name: count
          required: false
          type: integer
        - description: Return media later than this `min_id`.
          in: query
          name: min_id
          required: false
          type: string
        - description: Return media earlier than this `max_id`.
          in: query
          name: max_id
          required: false
          type: string
      responses:
        '200':
          description: Users feed entries.
          schema:
            $ref: '#/definitions/MediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
      summary: See the authenticated user's feed.
      tags:
        - users
  /users/self/media/liked:
    get:
      description: |
        See the list of media liked by the authenticated user. Private media is returned as long as the authenticated
        user has permission to view that media. Liked media lists are only available for the currently authenticated
        user.
      parameters:
        - description: Count of media to return.
          in: query
          name: count
          required: false
          type: integer
        - description: Return media liked before this id.
          in: query
          name: max_like_id
          required: false
          type: string
      responses:
        '200':
          description: Users media entries.
          schema:
            $ref: '#/definitions/MediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
      summary: See the list of media liked by the authenticated user.
      tags:
        - users
  /users/self/requested-by:
    get:
      description: List the users who have requested this user's permission to follow.
      responses:
        '200':
          description: List of users who have requested this user's permission to follow.
          schema:
            $ref: '#/definitions/UsersInfoResponse'
      security:
        - api_key: []
        - instagram_auth:
            - follower_list
      summary: List the users who have requested this user's permission to follow.
      tags:
        - relationships
  '/users/{user-id}':
    get:
      description: |
        Get basic information about a user. To get information about the owner of the access token, you can use
        **self** instead of the `user-id`.

        Security scope `public_content` is required to read information about other users.
      parameters:
        - description: 'The ID of a user to get information about, or **self** to retrieve information about authenticated user.'
          in: path
          name: user-id
          required: true
          type: string
      responses:
        '200':
          description: User basic information.
          schema:
            $ref: '#/definitions/UserResponse'
        '404':
          description: 'Not Found, user with such ID does not exist.'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get basic information about a user.
      tags:
        - users
  '/users/{user-id}/followed-by':
    get:
      description: |
        Get the list of users this user is followed by. To get users followed by the owner of the access token, you
        can use **self** instead of the `user-id`.
      parameters:
        - description: 'The ID of a user, or **self** to retrieve information about authenticated user.'
          in: path
          name: user-id
          required: true
          type: string
      responses:
        '200':
          description: List of users this user is followed by.
          schema:
            $ref: '#/definitions/UsersPagingResponse'
      security:
        - api_key: []
        - instagram_auth:
            - follower_list
      summary: Get the list of users this user is followed by.
      tags:
        - relationships
  '/users/{user-id}/follows':
    get:
      description: |
        Get the list of users this user follows. To get follows of the owner of the access token, you can use **self**
        instead of the `user-id`.
      parameters:
        - description: 'The ID of a user, or **self** to retrieve information about authenticated user.'
          in: path
          name: user-id
          required: true
          type: string
      responses:
        '200':
          description: List of users this user follows.
          schema:
            $ref: '#/definitions/UsersPagingResponse'
      security:
        - api_key: []
        - instagram_auth:
            - follower_list
      summary: Get the list of users this user follows.
      tags:
        - relationships
  '/users/{user-id}/media/recent':
    get:
      description: |
        Get the most recent media published by a user. To get the most recent media published by the owner of the
        access token, you can use **self** instead of the `user-id`.

        Security scope `public_content` is required to read information about other users.
      parameters:
        - description: 'The ID of a user to get recent media of, or **self** to retrieve media of authenticated user.'
          in: path
          name: user-id
          required: true
          type: string
        - description: Count of media to return.
          in: query
          name: count
          required: false
          type: integer
        - description: Return media before this UNIX timestamp.
          format: int64
          in: query
          name: max_timestamp
          required: false
          type: integer
        - description: Return media after this UNIX timestamp.
          format: int64
          in: query
          name: min_timestamp
          required: false
          type: integer
        - description: Return media later than this `min_id`.
          in: query
          name: min_id
          required: false
          type: string
        - description: Return media earlier than this `max_id`.
          in: query
          name: max_id
          required: false
          type: string
      responses:
        '200':
          description: Users media entries.
          schema:
            $ref: '#/definitions/MediaListResponse'
      security:
        - api_key: []
        - instagram_auth:
            - basic
            - public_content
      summary: Get the most recent media published by a user.
      tags:
        - users
  '/users/{user-id}/relationship':
    get:
      description: Get information about a relationship to another user.
      parameters:
        - description: The ID of a user to get information about.
          in: path
          name: user-id
          required: true
          type: string
      responses:
        '200':
          description: Relationship information.
          schema:
            $ref: '#/definitions/RelationshipResponse'
      security:
        - api_key: []
        - instagram_auth:
            - follower_list
      summary: Get information about a relationship to another user.
      tags:
        - relationships
    post:
      description: Modify the relationship between the current user and the target user.
      parameters:
        - description: The ID of the target user.
          in: path
          name: user-id
          required: true
          type: string
        - description: Type of action to apply for relationship with the user.
          enum:
            - follow
            - unfollow
            - block
            - unblock
            - approve
            - ignore
          in: query
          name: action
          required: true
          type: string
      responses:
        '200':
          description: Relationship information.
          schema:
            $ref: '#/definitions/RelationshipPostResponse'
      security:
        - api_key: []
        - instagram_auth:
            - relationships
      summary: Modify the relationship between the current user and the target user.
      tags:
        - relationships
definitions:
  CaptionData:
    properties:
      created_time:
        description: Caption creation UNIX timestamp
        type: string
      from:
        $ref: '#/definitions/UserShortInfo'
        description: User who created this caption
      id:
        description: ID of this caption
        type: string
      text:
        description: Caption text
        type: string
    type: object
  CommentEntry:
    properties:
      created_time:
        description: Comment creation UNIX timestamp
        type: string
      from:
        $ref: '#/definitions/UserShortInfo'
        description: User who posted this comment
      id:
        description: ID of this comment
        type: string
      text:
        description: Text of the comment
        type: string
    type: object
  CommentsCollection:
    properties:
      count:
        description: 'Nember of comments available, data does not necessary contain all comments'
        type: integer
      data:
        description: 'Collection of comment entries; **warning:** deprecated for Apps [created on or after Nov 17, 2015](http://instagram.com/developer/changelog/)'
        items:
          $ref: '#/definitions/CommentEntry'
        type: array
    type: object
  CommentsResponse:
    properties:
      data:
        description: Collection of comments
        items:
          $ref: '#/definitions/CommentEntry'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  CursorPaginationInfo:
    properties:
      next_cursor:
        description: The cursor ID of the next page
        type: string
      next_url:
        description: URL to retrieve next page of entries
        type: string
    type: object
  IdPaginationInfo:
    properties:
      next_max_id:
        description: The max ID of the next page
        type: string
      next_url:
        description: URL to retrieve next page of entries
        type: string
    type: object
  ImageInfo:
    properties:
      height:
        description: Image/video height in pixels
        type: integer
      url:
        description: URL of the image/video resource
        type: string
      width:
        description: Image/video width in pixels
        type: integer
    type: object
  ImagesData:
    properties:
      low_resolution:
        $ref: '#/definitions/ImageInfo'
        description: Image in low resolution
      standard_resolution:
        $ref: '#/definitions/ImageInfo'
        description: Image in standard resolution
      thumbnail:
        $ref: '#/definitions/ImageInfo'
        description: Thumbnail of the image
    type: object
  LikesCollection:
    properties:
      count:
        description: 'Nember of likes available, data does not necessary contain all comments'
        type: integer
      data:
        description: 'Collection of users who liked; **warning:** deprecated for Apps [created on or after Nov 17, 2015](http://instagram.com/developer/changelog/)'
        items:
          $ref: '#/definitions/UserShortInfo'
        type: array
    type: object
  LocationInfo:
    properties:
      id:
        description: ID of this location (in some responses it has a type of 'integer')
        type: string
      latitude:
        description: Location latitude
        format: double
        type: number
      longitude:
        description: Location longitude
        format: double
        type: number
      name:
        description: Location name
        type: string
    type: object
  LocationInfoResponse:
    properties:
      data:
        $ref: '#/definitions/LocationInfo'
        description: Location brief information
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  LocationSearchResponse:
    properties:
      data:
        description: List of found locations
        items:
          $ref: '#/definitions/LocationInfo'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  MediaEntry:
    properties:
      attribution:
        description: '??? Unknown ???'
        type: string
      caption:
        $ref: '#/definitions/CaptionData'
        description: Describes caption of this media
      comments:
        $ref: '#/definitions/CommentsCollection'
        description: Comments of this media entry
      created_time:
        description: Media creation UNIX timestamp
        type: string
      filter:
        description: Filter of this media entry
        type: string
      id:
        description: ID of a media entry
        type: string
      images:
        $ref: '#/definitions/ImagesData'
        description: Images data in different resolutions
      likes:
        $ref: '#/definitions/LikesCollection'
        description: Likes of this media entry
      link:
        description: Fixed URL of this media entry
        type: string
      location:
        $ref: '#/definitions/LocationInfo'
        description: Location data for this media if available
      tags:
        description: List of tags assigned to this media
        items:
          type: string
        type: array
      type:
        description: Type of this media entry
        enum:
          - image
          - video
        type: string
      user:
        $ref: '#/definitions/UserShortInfo'
        description: User who posted this media
      user_has_liked:
        description: Indicates whether authenticated user has liked this media or not
        type: boolean
      users_in_photo:
        description: Users located on this media entry
        items:
          $ref: '#/definitions/UserInPhoto'
        type: array
      videos:
        $ref: '#/definitions/VideosData'
        description: 'Videos data in different resolutions, applied for ''video'' type'
    type: object
  MediaEntryResponse:
    properties:
      data:
        $ref: '#/definitions/MediaEntry'
        description: Media resource information
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  MediaListResponse:
    properties:
      data:
        description: List of media entries
        items:
          $ref: '#/definitions/MediaEntry'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
      pagination:
        $ref: '#/definitions/IdPaginationInfo'
        description: Information for pagination
    type: object
  MediaSearchResponse:
    properties:
      data:
        description: Found media entries; some end-points do not return likes informtaion
        items:
          $ref: '#/definitions/MediaEntry'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  MetaData:
    properties:
      code:
        description: HTTP result code
        format: int32
        type: integer
    type: object
  Position:
    properties:
      x:
        description: X position (horizontal)
        format: float
        type: number
      'y':
        description: Y position (vertical)
        format: float
        type: number
    type: object
  RelationshipInfo:
    properties:
      incoming_status:
        description: Status of incoming relationship
        enum:
          - none
          - followed_by
          - requested_by
        type: string
      outgoing_status:
        description: Status of outgoing relationship
        enum:
          - none
          - follows
          - requested
        type: string
      target_user_is_private:
        description: Indicates whether target user is private or not
        type: boolean
    type: object
  RelationshipPostResponse:
    properties:
      data:
        $ref: '#/definitions/RelationshipStatus'
        description: Current relationship status
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  RelationshipResponse:
    properties:
      data:
        $ref: '#/definitions/RelationshipInfo'
        description: Relationship information
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  RelationshipStatus:
    properties:
      outgoing_status:
        description: Status of outgoing relationship
        enum:
          - none
          - follows
          - requested
        type: string
    type: object
  StatusResponse:
    properties:
      data:
        description: No data - 'null'
        type: string
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  TagInfo:
    properties:
      media_count:
        description: Overall number of media entries taged with this name
        format: int64
        type: integer
      name:
        description: Tag name
        type: string
    type: object
  TagInfoResponse:
    properties:
      data:
        $ref: '#/definitions/TagInfo'
        description: Tag brief information
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  TagMediaListResponse:
    properties:
      data:
        description: List of media entries with this tag
        items:
          $ref: '#/definitions/MediaEntry'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
      pagination:
        $ref: '#/definitions/TagPaginationInfo'
        description: Information for pagination
    type: object
  TagPaginationInfo:
    properties:
      deprecation_warning:
        description: 'The deprication warning, if information is available'
        type: string
      min_tag_id:
        description: The min ID of a tag for the next page
        type: string
      next_max_id:
        description: Depricated. Use min_tag_id instead
        type: string
      next_max_tag_id:
        description: The max ID of a tag for the next page
        type: string
      next_min_id:
        description: Depricated. Use max_tag_id instead
        type: string
      next_url:
        description: URL to retrieve next page of entries
        type: string
    type: object
  TagSearchResponse:
    properties:
      data:
        description: List of found tags with brief statistics
        items:
          $ref: '#/definitions/TagInfo'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  UserCounts:
    properties:
      followed_by:
        description: Number of followers of this user
        format: int32
        type: integer
      follows:
        description: Number of users followed by this user
        format: int32
        type: integer
      media:
        description: Number of user media
        format: int32
        type: integer
    type: object
  UserInPhoto:
    properties:
      position:
        $ref: '#/definitions/Position'
        description: Position in photo
      user:
        $ref: '#/definitions/UserShortInfo'
        description: User who is indicated on the photo
    type: object
  UserInfo:
    properties:
      bio:
        description: User biography
        type: string
      counts:
        $ref: '#/definitions/UserCounts'
        description: User statistics (counters)
      full_name:
        description: User full name
        type: string
      id:
        description: User ID
        type: string
      profile_picture:
        description: URL to user profile picture
        type: string
      username:
        description: 'User name, nickname'
        type: string
      website:
        description: URL to user web-site
        type: string
    type: object
  UserResponse:
    properties:
      data:
        $ref: '#/definitions/UserInfo'
        description: User basic information
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  UserShortInfo:
    properties:
      full_name:
        description: User full name
        type: string
      id:
        description: User ID
        type: string
      profile_picture:
        description: URL to user profile picture
        type: string
      username:
        description: 'User name, nickname'
        type: string
    type: object
  UsersInfoResponse:
    properties:
      data:
        description: User short information entries
        items:
          $ref: '#/definitions/UserShortInfo'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
    type: object
  UsersPagingResponse:
    properties:
      data:
        description: List of user short information entries
        items:
          $ref: '#/definitions/UserShortInfo'
        type: array
      meta:
        $ref: '#/definitions/MetaData'
        description: Response meta-data
      pagination:
        $ref: '#/definitions/CursorPaginationInfo'
        description: Information for pagination
    type: object
  VideosData:
    properties:
      low_resolution:
        $ref: '#/definitions/ImageInfo'
        description: Video in low resolution
      standard_resolution:
        $ref: '#/definitions/ImageInfo'
        description: Video in standard resolution
    type: object