Instagram /source/create options

These paramaters apply to Instagram Managed Sources.

parameters
optional

This parameter sets options for the source.

The following options are supported:

  • comments -- set to true, if you want to receive comment interactions.
  • likes -- set to true, if you want to receive like interactions.

For example:

parameters={
    "comments": true,
    "likes": true
}
resources
required

The list of resources to monitor. For this source type resources are locations, tags or users.

For all resources you must specify the type:

  • type -- type of data: user, tag, location.

User resources

When type is set to user, the following parameter must be present:

  • value -- user ID.

For example:

resources=[
    {
        "parameters": {
            "type": "user",
            "value": "1"
        }
    }
]

Tag resources

When type is set to tag, the following parameter must be present:

  • value -- tag name.

For example:

resources=[
    {
        "parameters": {
            "type": "tag",
            "value": "cats"
        }
    }
]

Location resources

When type is set to location the following parameters must be present:

  • lat -- latitude.
  • lng -- longitude.

When type is set to location, we first find registered locations within that latitude/longitude and then look for checkins in those locations.

There is also an optional parameter which defines the radius of a circle centered at lat/long. It defaults to 1,000:

  • distance -- an integer, between 1 and 5,000 meters.

For example:

resources=[
    {
        "parameters": {
            "type": "location",
            "lat": 51.4553,
            "lng": -0.9689,
            "distance": 50
        }
    }
]
auth
optional

Access tokens the source should use when accessing the Instagram API.

For each token the following parameters are supported:

  • parameters.value -- a valid OAuth2 token (required).
  • expires_at -- identity resource expiry date/time as a UTC timestamp (optional).

We will send an email notification five days before the token is due to expire. Be aware that we will continue to use the token. If it expires, the source will be shut off and you will see error messages in the error log in DataSift's UI.

For example:

auth=[
    {
        "parameters": {
            "value": "kfDecg0a9le3f..."
        },
        expires_at: 1388556000
    }
]