Skip to main content
POST
/
data-stream
/
ids
Fetch many data-streams
curl --request POST \
  --url https://api-dev.narrative.io/data-stream/ids \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "cddfface-beda-4f84-ab22-a9933fad3992",
    "6460aa19-ddb2-424c-a54e-0f80b82b1698"
  ]
}
'
{
  "records": [
    {
      "id": "f94e8803-fc03-4c3e-a3fc-c3ffe3993788",
      "company_id": 100,
      "name": "best data stream name",
      "slug": "this-is-a-slug",
      "content": {
        "description": "Fabulous Data Stream even better than anything out there!",
        "icon": "https://some.icon.png",
        "sections": [
          {
            "title": "some title",
            "description": "some description",
            "image": "some-image"
          },
          {
            "whatever": "whatever json structure FE would like to have here.",
            "free_form": "json here"
          }
        ]
      },
      "tags": [
        "tag1",
        "tag2"
      ],
      "category": "categoryA",
      "offers": [
        {
          "id": "16310512-a8fb-4ce8-aec3-573693067df9",
          "channel": "data_streams_market",
          "licensing": {
            "period": "P90D",
            "license": {
              "name": "narrative opendata license"
            }
          },
          "pricing": {
            "type": "per_record",
            "micro_cents_usd": 70000
          },
          "shops": null
        },
        {
          "id": "d7542ec5-558f-4e98-9ff6-e049b24798fa",
          "channel": "data_shop",
          "licensing": {
            "period": "P90D",
            "license": {
              "name": "narrative opendata license"
            }
          },
          "pricing": {
            "type": "per_record",
            "micro_cents_usd": 50000
          },
          "shops": null
        },
        {
          "id": "5d52d8d8-b683-4ef4-9220-31347dc2237f",
          "channel": "data_shop",
          "licensing": {
            "period": "P90D",
            "license": {
              "name": "narrative opendata license"
            }
          },
          "pricing": {
            "type": "max_price_per_record",
            "micro_cents_usd": 30000
          },
          "shops": [
            "only.on.tld.com"
          ]
        }
      ],
      "data_rules": {
        "column_sets": [
          {
            "dataset_id": 99999,
            "fields": [
              {
                "field": "col1",
                "filter": null,
                "exported": true
              },
              {
                "field": "col2",
                "filter": "include_all_values_including_nulls_filter",
                "exported": true
              },
              {
                "field": "col3",
                "filter": "include_only_if_not_null_filter",
                "exported": true
              },
              {
                "field": "col4",
                "filter": {
                  "type": "include",
                  "list": [
                    "this",
                    "that",
                    "that too",
                    "some more"
                  ]
                },
                "exported": true
              },
              {
                "field": "col5",
                "filter": {
                  "type": "exclude",
                  "list": [
                    "this",
                    "that",
                    "that too",
                    "some more"
                  ]
                },
                "exported": true
              },
              {
                "field": "col6",
                "filter": {
                  "min": {
                    "type": "inclusive",
                    "value": "-100"
                  },
                  "max": {
                    "type": "inclusive",
                    "value": "100"
                  }
                },
                "exported": true
              },
              {
                "field": "col6",
                "filter": {
                  "min": null,
                  "max": {
                    "type": "exclusive",
                    "value": "timestamp01"
                  }
                },
                "exported": false
              },
              {
                "field": "col7",
                "filter": {
                  "type": "include",
                  "list": [
                    "true"
                  ]
                },
                "exported": true
              },
              {
                "field": "col8",
                "filter": {
                  "recency": "P30D",
                  "from": null,
                  "to": {
                    "type": "exclusive",
                    "value": "timestamp01"
                  }
                },
                "exported": true
              }
            ]
          }
        ],
        "attributes": [
          {
            "attribute_id": 123,
            "fields": [
              {
                "field": "col1",
                "filter": null,
                "exported": true
              },
              {
                "field": "col2",
                "filter": "include_all_values_including_nulls_filter",
                "exported": true
              },
              {
                "field": "col3",
                "filter": "include_only_if_not_null_filter",
                "exported": true
              },
              {
                "field": "col4",
                "filter": {
                  "type": "include",
                  "list": [
                    "this",
                    "that",
                    "that too",
                    "some more"
                  ]
                },
                "exported": true
              },
              {
                "field": "col5",
                "filter": {
                  "type": "exclude",
                  "list": [
                    "this",
                    "that",
                    "that too",
                    "some more"
                  ]
                },
                "exported": true
              },
              {
                "field": "col6",
                "filter": {
                  "min": {
                    "type": "inclusive",
                    "value": "-100"
                  },
                  "max": {
                    "type": "inclusive",
                    "value": "100"
                  }
                },
                "exported": true
              },
              {
                "field": "col6",
                "filter": {
                  "min": null,
                  "max": {
                    "type": "exclusive",
                    "value": "timestamp01"
                  }
                },
                "exported": false
              },
              {
                "field": "col7",
                "filter": {
                  "type": "include",
                  "list": [
                    "true"
                  ]
                },
                "exported": true
              },
              {
                "field": "col8",
                "filter": {
                  "recency": "P30D",
                  "from": null,
                  "to": {
                    "type": "exclusive",
                    "value": "timestamp01"
                  }
                },
                "exported": true
              },
              {
                "field": "col9",
                "filter": {
                  "expressions": [
                    "col9 > -90",
                    "col9 < 90"
                  ]
                },
                "exported": true
              }
            ],
            "optional": true
          },
          {
            "attribute_id": 321,
            "fields": [
              {
                "field": "col9",
                "filter": {
                  "expressions": [
                    "col9 > -90",
                    "col9 < 90"
                  ]
                },
                "exported": false
              }
            ],
            "optional": false
          }
        ],
        "deduplication": {
          "period": "P60D",
          "column_references": null,
          "attribute_references": [
            {
              "attribute_id": 123,
              "column_names": [
                "col9",
                "col9.foo.bar"
              ]
            }
          ]
        },
        "frequency_filter": {
          "column_references": null,
          "attribute_references": [
            {
              "attribute_id": 123,
              "column_names": [
                "col9.foo.bar"
              ]
            }
          ],
          "min_inclusive": 2,
          "max_inclusive": 5
        }
      },
      "auth_rules": {
        "company_constraint": {
          "type": "inclusion",
          "company_ids": [
            160,
            1701
          ]
        }
      },
      "created_by": 5000,
      "created_at": "2021-06-29T10:58:36.726Z",
      "updated_at": "2021-06-29T10:58:36.726Z",
      "datasets": null
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ids
string<uuid>[]
required

Response

OK

records
object[]
required