Customer Lists - Lookalikes

A Lookalike segment can be created from a first-party seed Customer List segment. The segment can be used to target or exclude a specific group of users that "behave like" the seed audience segment.

If the original seed Segment has new identfiers added to it, the Lookalike segment will also be updated with new users.

Attributes

Attribute	Description	Required	Possible Values
ad_account_id	Ad Account ID	R
creation_spec	Lookalike Creation Spec dictionary	R	(see below)
description	Audience Segment Description	O
name	Audience Segment name	R
retention_in_days	# of days to retain audience members	R	(Max 180)
source_type	Data source type	R	LOOKALIKE

Creation Spec Details

Attribute	Description	Required	Possible Values
seed_segment_id	Seed Audience Segment ID	R
type	The type of Lookalike to be created	O	BALANCE (default), SIMILARITY, REACH
countries	List of ISO-2 Country Code	R	["UK", "US"] OR ["US"] etc
country [Deprecated]	ISO-2 Country Code	R

Create an Lookalike Segment

curl -X POST \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json" \
   -d '{"segments": [{"name": "lookalikes of all the sams in the world", "description": "similar to all the sams in the world", "source_type": "LOOKALIKE", "retention_in_days": 180, "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74", "creation_spec":{"seed_segment_id": "5677923948298240", "country": "US", "type": "REACH"}}]}' \
   "https://adsapi.snapchat.com/v1/adaccounts/{ad_acount_id}/segments"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "57e18036000733c0f1abd670",
  "segments": [
    {
      "sub_request_status": "SUCCESS",
      "segment": {
        "id": "5652536396611584",
        "updated_at": "2016-09-20T11:30:15.448-07:00",
        "created_at": "2016-09-20T11:30:15.429-07:00",
        "name": "lookalikes of all the sams in the world",
        "ad_account_id": "d47d2516-4f1f-46f0-a63c-31a46804c3aa",
        "description": "similar to all the sams in the world",
        "status": "ACTIVE",
        "source_type": "LOOKALIKE",
        "retention_in_days": 180,
        "approximate_number_users": 0,
        "creation_spec": {
          "seed_segment_id": "5677923948298240",
          "country": "US"
          "type": "REACH"
        }
      }
    }
  ]
}

This endpoint will create a Customer List Lookalike Segment within a specified ad account.

HTTP Request

POST https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/segments

Parameters

Parameter	Default	Description
ad_account_id		Ad Account ID