curl 'https://api.ingeniapi.com/v2/items?api_key=$api_key'

Response:

[
  {
    "bundle_id": 778,
    "bundle_name": "Here we go again",
    "concordance": null,
    "created_at": "2016-05-10T15:35:59Z",
    "id": "61265a8b2e56ff9693753fd044630ed5",
    "item_state": "processed",
    "language": "en",
    "last_classified_at": "2016-05-10T15:38:47Z",
    "membership_degree": null,
    "updated_at": "2016-05-10T15:38:47Z",
    "tag_sets": [
      {
        "Cooking": {
          "id": 42,
          "tags": [
            {
              "id": 81656,
              "name": "french-cuisine",
              "user_selected": "t",
              "user_assigned": true,
              "score": "0.06",
              "machine_score": "0.06",
              "rule_score": "0",
              "user_assigned_score": "0"
            }
          ]
        }
      }
    ],
    "text": "Some inline text",
    "metadata": [
      null
    ]
  },
  {
    "bundle_id": 778,
    "bundle_name": "Here we go again",
    "concordance": null,
    "created_at": "2016-05-10T16:03:59Z",
    "id": "3fdb62127e7a839e3f4e0ab6de7cd869",
    "item_state": "processed",
    "language": "en",
    "last_classified_at": "2016-05-10T16:04:00Z",
    "membership_degree": null,
    "updated_at": "2016-05-10T16:04:01Z",
    "tag_sets": [
      {
        "Tech": {
          "id": 57,
          "tags": [
            {
              "id": 91567,
              "name": "wearables",
              "user_selected": "t",
              "user_assigned": true,
              "score": "0.06",
              "machine_score": "0.06",
              "rule_score": "0",
              "user_assigned_score": "0"
            }
          ]
        }
      }
    ],
    "text": "Smartwatch cheats force Thai students back to exam halls - BBC News\nSome 3,000 students in Thailand must retake university entrance exams after a cheating scam involving cameras and smartwatches was uncovered.The sophisticated scam happened at Rangsit University in Bangkok.The ...",
    "metadata": [
      null,
      {
        "name": "url-fetched",
        "type": "date",
        "content": "2016-05-10 16:03:59"
      },
      {
        "name": "url",
        "type": "url",
        "content": "http://www.bbc.co.uk/news/world-asia-36253769"
      }
    ]
  }
]

curl 'https://api.ingeniapi.com/v2/items/61265a8b2e56ff9693753fd044630ed5?api_key=$api_key'

Response:

{
  "bundle_id": 778,
  "bundle_name": "Tech Startups",
  "concordance": null,
  "created_at": "2016-05-10T15:35:59Z",
  "id": "61265a8b2e56ff9693753fd044630ed5",
  "item_state": "processed",
  "language": "en",
  "last_classified_at": "2016-05-10T15:38:47Z",
  "membership_degree": null,
  "updated_at": "2016-05-10T15:38:47Z",
  "tag_sets": [
    {
      "Tech": {
        "id": 57,
        "tags": [
          {
            "id": 91567,
            "name": "wearables",
            "user_selected": "t",
            "user_assigned": true,
            "score": "0.06",
            "machine_score": "0.06",
            "rule_score": "0",
            "user_assigned_score": "0"
          }
        ]
      }
    }
  ],
  "text": "Some inline text",
  "metadata": [
    null
  ]
}

# Simply post item's text
curl -X POST \
  -F'json={ "text" : "Some inline text" }' \
  'https://api.ingeniapi.com/v2/items?api_key=$api_key&classify=true'

# Create an item with some text and assign a tag ('foo') to it with a score of 0.2.
curl -X POST \
  -F'json={ "text" : "Some inline text" , "tags" : { "foo" : 0.2 } }' \
  'https://api.ingeniapi.com/v2/items?api_key=$api_key&classify=true'

# Create an item with some text, create a new tag set ('my tag set') and add
# a tag ('foo') with a score of 0.2 to that tag set..
curl -X POST \
  -F'json={ "text" : "Some inline text" , "tag_sets" : { "my tag set" :  { "foo" : 0.2 } } }' \
  'https://api.ingeniapi.com/v2/items?api_key=$api_key&classify=true'

# Create an item with the tag ('foo')
curl -X POST \
  -F'json={ "text" : "Some inline text" , "tags" : [ "foo"]  }' \
  'https://api.ingeniapi.com/v2/items=$api_key&classify=true'

# Post url to retrieve content from and create an item with that content
curl -X POST \
  -F'json={ "url" : "https://www.zdziarski.com/blog/?p=3875" }' \
  'https://api.ingeniapi.com/v2/items?api_key=$api_key'

# Post a file using multipart/form-data upload and create an item with that content
curl -X POST \
  -F'json={}' \
  -F'[email protected]' \
  'https://api.ingeniapi.com/v2/items?api_key=$api_key&classify=true&update_existing=true'

curl -X PUT \
-F'json={ "text" : "Some updated text" , "tags" : [ "foo"]  }' \
'https://api.ingeniapi.com/v2/items/61265a8b2e56ff9693753fd044630ed5?api_key=$api_key

Response:

{
  "bundle_id": 778,
  "created_at": "2016-05-10T15:35:59Z",
  "id": "61265a8b2e56ff9693753fd044630ed5",
  "last_classified_at": "2016-05-10T16:54:56Z",
  "updated_at": "2016-05-10T16:54:57Z",
  "text": "Some updated text",
  "tag_sets": [
    {
      "Technologia": {
        "id": 2860,
        "tags": [
          {
            "id": 189475,
            "name": "foo",
            "user_selected": "t",
            "user_assigned": true,
            "score": "0.0",
            "machine_score": "0",
            "rule_score": null,
            "user_assigned_score": "0"
          }
        ]
      }
    }
  ]
}

curl -X DELETE 'https://api.ingeniapi.com/v2/items/61265a8b2e56ff9693753fd044630ed5?api_key=$api_key'

Response:

{
  "61265a8b2e56ff9693753fd044630ed5": "destroyed",
  "bundle_id": 778
}