Target Account List Examples

List all Target Account Lists

GET /audience/v1/target_accounts

Request:

curl --user dev@example.com:my-password-is-great \
"https://services.adroll.com/audience/v1/target_accounts?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"

Response:

{
  "results": [
    {
      "advertisable_eid": "MY_ADVERTISABLE_EID",
      "eid": "TARGET_ACCOUNT_LIST_EID",
      "items_count": 10000,
      "name": "Top 10K",
      "scoring_at": "2019-07-01T16:34:27.448382+00:00",
      "scoring_auc": 0.99100798368454,
      "scoring_by_user_eid": "USER_EID",
      "scoring_filename": "top-1k-domains.csv",
      "scoring_grades": {
        "A": {
          "threshold": 30,
          "items_count": 468,
          "min_item": {
            "domain": "theglobeandmail.com",
            "score": 0.999897
          }
        },
        "C": {
          "threshold": 85,
          "items_count": 365,
          "min_item": {
            "domain": "reshet.tv",
            "score": 0.939022
          }
        },
        "B": {
          "threshold": 80,
          "items_count": 2057,
          "min_item": {
            "domain": "makeagif.com",
            "score": 0.973098
          }
        },
        "D": {
          "threshold": 95,
          "items_count": 2696,
          "min_item": {
            "domain": "profiles.google.com",
            "score": 0.029493
          }
        },
        "F": {
          "threshold": 100,
          "items_count": 2562,
          "min_item": null
        },
        "unscored_count": 1852,
        "scored_count": 8148
      },
      "scoring_holdout1_model_id": null,
      "scoring_holdout1_retries": 0,
      "scoring_holdout1_status": null,
      "scoring_holdout2_model_id": null,
      "scoring_holdout2_retries": 0,
      "scoring_holdout2_status": null,
      "scoring_holdout3_model_id": null,
      "scoring_holdout3_retries": 0,
      "scoring_holdout3_status": null,
      "scoring_holdout4_model_id": null,
      "scoring_holdout4_retries": 0,
      "scoring_holdout4_status": null,
      "scoring_holdout5_model_id": null,
      "scoring_holdout5_retries": 0,
      "scoring_holdout5_status": null,
      "scoring_items_count": 862,
      "scoring_items_pending": true,
      "scoring_model_id": "f3f3e5cd-d606-4033-93cd-10c1af2cc232",
      "scoring_production_model_id": null,
      "scoring_production_retries": 0,
      "scoring_production_status": null,
      "scoring_status": "complete",
      "sfdc_company_list_name": null,
      "sfdc_company_list_object_id": null,
      "sfdc_create_accounts": false,
      "sfdc_initial_pull_pending": null,
      "sfdc_scoring_company_list_name": null,
      "sfdc_scoring_company_list_object_id": null,
      "sfdc_sync_state": "none",
      "sfdc_synced_at": null,
      "sfdc_train_pending": null,
      "suggestions_count": 2955,
      "tiers": [
        {
          "eid": "all",
          "items_count": 10000,
          "tal_eid": "TARGET_ACCOUNT_LIST_EID"
        },
        {
          "items_count": 9998,
          "eid": "untiered",
          "name": null,
          "tal_eid": "TARGET_ACCOUNT_LIST_EID"
        },
        {
          "items_count": 2,
          "eid": "TARGET_ACCOUNT_GROUP_EID",
          "name": "UCLA",
          "tal_eid": "TARGET_ACCOUNT_LIST_EID"
        }
      ],
      "updated_at": "2019-09-16T13:28:43.678412+00:00",
      "updated_by_user_eid": null
    }
  ]
}

List all accounts in a Target Account List

GET /audience/v1/target_accounts

Request:

curl --user dev@example.com:my-password-is-great \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"

Response:

{
  "total_items": 10000,
  "results": [
    {
      "domain": "000webhost.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.99998,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "007.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.146781,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "013.nl",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.012467,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "01.ibm.com",
      "updated_at": "2019-07-01T16:57:59.552388+00:00",
      "source": "user_uploaded",
      "score": null,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "01net.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.999756,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "03.ibm.com",
      "updated_at": "2019-07-01T16:57:59.552388+00:00",
      "source": "user_uploaded",
      "score": null,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "0.gravatar.com",
      "updated_at": "2019-07-01T16:57:59.552388+00:00",
      "source": "user_uploaded",
      "score": null,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "1001fonts.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.682038,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "1001tracklists.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.869826,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    },
    {
      "domain": "101wkqx.com",
      "updated_at": "2019-07-01T16:58:26.701943+00:00",
      "source": "user_uploaded",
      "score": 0.006115,
      "sfdc_account_id": null,
      "sfdc_synced_at": null
    }
  ]
}

Add new accounts to a Target Account List

POST /audience/v1/target_accounts/(tal_eid)/tiers/(ta_tier_eid)/items

Request:

curl -X POST --user dev@example.com:my-password-is-great \
-H "Content-Type: application/json" \
-d '{"items":[{"domain":"new_domain.com"}]}' \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"

Response:

{
  "existing_domains": [],
  "new_domains": [
    "new_domain.com"
  ]
}

Remove accounts from a Target Account List

DELETE /audience/v1/target_accounts/(tal_eid)/tiers/(ta_tier_eid)/items

Request:

curl -X DELETE --user dev@example.com:my-password-is-great \
-H "Content-Type: application/json" \
-d '{"domains":["new_domain.com"]}' \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"

Response:

The response is going to be empty with HTTP status code 204 (NO CONTENT)