Add one or more resources to a Managed Source.

An HTTPS PUT request sent to:

A successful call to this endpoint returns: 200 OK plus a JSON object. The JSON object is the same as the JSON returned by the /source/get endpoint.


Parameter Description

The id of the source you're adding resources to.


An array of the source-specific resources that you're adding.

The resources parameter is an array so you can combine several definitions in a single JSON block, of the same type or different types. For instance, Instagram takes five different types: user, tag, area, location, and popular, which can all be combined in the same resource array as show in the following example:


Allows you to suppress validation of the resources. Can be:

  • true, t, or 1
  • false, f, or 0

Defaults to true.

We recommend that you validate any resources you want to use. You can turn validation off by setting this parameter to false. For example, if you are adding a large set of Facebook Pages, validation will make the process run more slowly.

Invalid resources will create entries in the connection log. If you experience problems with a resource that has not been validated, you can call /source/resource/remove to remove the resource and then add it again, this time with validation.


  1. Add a 'tag' resource to an Instagram Managed Source:

    curl -X PUT '' \
        -d 'id=da4f8df71a0f43698acf9240b5ad668f' \
        -d 'resources=[{"parameters": {"type": "tag", "value": "cats"}}]' \
        -H 'Authorization: datasift-user:datasift-key'

  2. Add a 'page' resource to a Facebook Pages Managed Source:

    curl -X PUT '' \
        -d 'id=ee4f8df71a0f43698acf9240b5ad668f' \
        -d 'resources=[{"parameters":{"title": "The Guardian", "id": "10513336322"}}]' \
        -H 'Authorization: datasift-user:datasift-key'


  1. All calls to the API must be properly authenticated with a DataSift username and API key.
  2. All calls to the API must be versioned. The current version is v1.3.

Resource information

Rate limit cost: 25

Requires authentication: Yes

Response formats: JSON, JSONP