How Do I Format Data for Submission?

All Python examples provided in this guide were scripted using Python 3.0.

How do I format data for submission?

You can submit data using the following formats: JSON, CSV, XML, TSV (tab separated values). JSON is the preferred format.

For all data formats the submitted data must identify the data/record type in addition to the list of data records. For CSV and TSV the record type must be provided as one of the columns. For JSON and XML the record type is defined in a separate top level field. The record type field can be one of the following values: “host”, “ip”, “url”, “email”, or “hash”.

Here's a sample data submission using JSON:

  {
    "feed": {
      "record_type": "ip",
      "record": [ {
        "ip": "1.162.130.163",
        "property": "Bot Generic",
        "detected": "20200505T103644Z"
    }]}
  }

Back