Retrieve social transactions in bulk

Search transactions in bulk by providing the IDs.

This is best used in combination with webhooks - you can directly take the IDs from "TRANSACTIONS.ADDED" and "TRANSACTIONS.UPDATED" webhook notifications and pass on to this API to get the updated transaction items.

Check the category field from the work platform API response or the "Category" column in this data guide to see which platfroms we serve under "social".

POST /v1/social/income/transactions/search

Basic auth

curl 'https://api.sandbox.insightiq.ai/v1/social/income/transactions/search' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}'

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "created_at": "2020-03-27T12:56:34.534978",
      "updated_at": "2020-03-27T12:56:34.534978",
      "user": {
        "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
        "name": "John Doe"
      },
      "account": {
        "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
        "platform_username": "[email protected]"
      },
      "work_platform": {
        "id": "fb83e3ca-eae7-4eaa-bf51-601ea4b3daeb",
        "name": "Instagram",
        "logo_url": "https://insightiq.ai/storage/instagram.png"
      },
      "amount": 123.45,
      "type": "AD",
      "cpm": 6.78,
      "currency": "USD",
      "external_id": "5790fbc3-b022-437b-abf8-0492c7a82056",
      "transaction_at": "2020-03-27T12:56:34.534978",
      "platform_profile_id": "UCEyLTzBtHJhlUwkeWhxfMXw",
      "platform_profile_name": "Peter Parker"
    }
  ]
}

Returns all transaction objects matching the IDs.

Body

· SocialTransactionSearch

application/json

ids array of string · min items: 1· max items: 100 required

List of upto 100 social transaction IDs for which to fetch data

Body

Responses