Prospecting API Reference

Note

If you use the API provided here, you are subject to the API Terms of Use. To be able to create prospecting objects your advertisable(s) must be opted-in to the Prospecting Services Addendum.

Note

We’ve introduced API keys, please read Migrating to API Keys

Description

Prospecting API v2

Operations

GET /prospecting/api/v2/adgroups/(adgroup)

Get AdGroup by its EID.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to get.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "ads": [
      {
        "ad_eid": "string",
        "ad_eids": "string",
        "adgroup_eid": "string",
        "admin_status": "string",
        "advertisable_eid": "string",
        "campaign_eid": "string",
        "campaign_name": "string",
        "eid": "string",
        "is_active": true,
        "skip_approve_ad": true,
        "status": "string"
      }
    ],
    "advertisable_eid": "string",
    "attribute_targets": [
      {
        "name": "string",
        "options": [
          {
            "name": "string",
            "target": true
          }
        ]
      }
    ],
    "attribute_targets_segment": "string",
    "audience": {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "size": 0,
      "source_segment_eid": "string",
      "target_segment_eid": "string",
      "updated_at": "string"
    },
    "auto_audience": true,
    "auto_geo_targets": true,
    "campaign_eid": "string",
    "created_at": "string",
    "device_targets": {},
    "eid": "string",
    "geo_targets": [
      {
        "city": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region_code": "string"
        },
        "country": {
          "code": "string",
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "geo_eid": "string",
        "geo_type": "string",
        "metro": {
          "boundaries": "string",
          "country": "string",
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "name": "string",
        "operation": "string",
        "postal_code": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string"
        },
        "region": {
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": "string",
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region": "string"
        }
      }
    ],
    "is_active": true,
    "name": "string",
    "status": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/adgroups/(adgroup)

Edit an AdGroup by its EID.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to edit.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "ads": [
    {
      "ad_eid": "string",
      "ad_eids": "string",
      "admin_status": "string",
      "event_source": "fortyniner-ui",
      "is_active": true,
      "skip_approve_ad": true,
      "user_status": "string"
    }
  ],
  "attribute_targets": [
    {
      "event_source": "fortyniner-ui",
      "name": "string",
      "options": [
        {
          "event_source": "fortyniner-ui",
          "name": "string",
          "target": true
        }
      ]
    }
  ],
  "attribute_targets_segment": "string",
  "auto_audience": true,
  "auto_geo_targets": true,
  "device_targets": {},
  "event_source": "fortyniner-ui",
  "geo_targets": [
    {
      "eid": "string",
      "event_source": "fortyniner-ui",
      "geo_type": "string",
      "operation": "string"
    }
  ],
  "is_active": true,
  "name": "string",
  "segments": [
    {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "event_source": "fortyniner-ui",
      "is_active": true,
      "is_negative": true,
      "segment_eid": "string",
      "segment_targeting_type": "string",
      "updated_at": "string"
    }
  ],
  "user_status": "string"
}
Schema
Type

object

ads
Type

array of items

attribute_targets
Type

array of items

attribute_targets_segment
Type

string

auto_audience
Type

boolean

auto_geo_targets
Type

boolean

device_targets
Type

object

event_source
Type

string

Default

fortyniner-ui

geo_targets
Type

array of items

is_active
Type

boolean

name
Type

string

segments
Type

array of items

user_status
Type

string

Enum

paused, active

Responses:

200

Schema as JSON:

{
  "results": {
    "ads": [
      {
        "ad_eid": "string",
        "ad_eids": "string",
        "adgroup_eid": "string",
        "admin_status": "string",
        "advertisable_eid": "string",
        "campaign_eid": "string",
        "campaign_name": "string",
        "eid": "string",
        "is_active": true,
        "skip_approve_ad": true,
        "status": "string"
      }
    ],
    "advertisable_eid": "string",
    "attribute_targets": [
      {
        "name": "string",
        "options": [
          {
            "name": "string",
            "target": true
          }
        ]
      }
    ],
    "attribute_targets_segment": "string",
    "audience": {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "size": 0,
      "source_segment_eid": "string",
      "target_segment_eid": "string",
      "updated_at": "string"
    },
    "auto_audience": true,
    "auto_geo_targets": true,
    "campaign_eid": "string",
    "created_at": "string",
    "device_targets": {},
    "eid": "string",
    "geo_targets": [
      {
        "city": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region_code": "string"
        },
        "country": {
          "code": "string",
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "geo_eid": "string",
        "geo_type": "string",
        "metro": {
          "boundaries": "string",
          "country": "string",
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "name": "string",
        "operation": "string",
        "postal_code": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string"
        },
        "region": {
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": "string",
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region": "string"
        }
      }
    ],
    "is_active": true,
    "name": "string",
    "status": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/adgroups/(adgroup)/audience

Retrieve the audience for the specified AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to get audience from.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "size": 0,
    "source_segment_eid": "string",
    "target_segment_eid": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/adgroups/(adgroup)/audience

Create an audience for the specified AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to create an audience for.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "event_source": "fortyniner-ui",
  "size": 0,
  "source_segment_eid": "string"
}
Schema
Type

object

event_source
Type

string

Default

fortyniner-ui

size
Required

True

Type

integer

Format

int32

source_segment_eid
Type

string

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "size": 0,
    "source_segment_eid": "string",
    "target_segment_eid": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/adgroups/(adgroup)/flights

Get all Flights associated with an AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to get Flights from.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": [
    {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "end_date": "string",
      "start_date": "string",
      "updated_at": "string"
    }
  ]
}
Schema
Type

object

results
Type

array of items

POST /prospecting/api/v2/adgroups/(adgroup)/flights

Create a new Flight for an AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID that the new Flight is being added to

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "end_date": "string",
  "event_source": "fortyniner-ui",
  "start_date": "string"
}
Schema
Type

object

end_date

Flight end date.

Type

string

event_source
Type

string

Default

fortyniner-ui

start_date

Flight start date.

Required

True

Type

string

Responses:

200

Flight created successfully.

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "end_date": "string",
    "start_date": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

400

The Flight was not created.

  • Your Flight might be missing start/end dates.

  • The start date might be greater than the end date.

  • Your Flight might be overlapping with another of the adgroup’s Flights.

Schema as JSON:

{
  "code": 0,
  "message": "string"
}
Schema
Type

object

code

HTTP error code.

Type

integer

Format

int32

message

String, list, or dictionary of error messages. If a dictionary, the keys will be field names and the values will be lists of messages.

Type

string

GET /prospecting/api/v2/adgroups/(adgroup)/geo-targets

Retrieve GeoTargets for the specified AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to get GeoTargets from.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "data": [
      {
        "city": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region_code": "string"
        },
        "country": {
          "code": "string",
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "geo_eid": "string",
        "geo_type": "string",
        "metro": {
          "boundaries": "string",
          "country": "string",
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "name": "string",
        "operation": "string",
        "postal_code": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string"
        },
        "region": {
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": "string",
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region": "string"
        }
      }
    ],
    "eid": "string"
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/adgroups/(adgroup)/geo-targets

Edit GeoTargets for the specified AdGroup.

Parameters:

Path Parameters

Name

Required

Type

Description

adgroup

True

string

AdGroup EID to add GeoTargets to.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

[
  {
    "eid": "string",
    "operation": "string"
  }
]
Schema
Type

array

Responses:

200

Schema as JSON:

{
  "results": {
    "data": [
      {
        "city": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region_code": "string"
        },
        "country": {
          "code": "string",
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "geo_eid": "string",
        "geo_type": "string",
        "metro": {
          "boundaries": "string",
          "country": "string",
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "name": "string",
        "operation": "string",
        "postal_code": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string"
        },
        "region": {
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": "string",
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region": "string"
        }
      }
    ],
    "eid": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/advertisables/(adv)/campaigns

Get campaigns for the given advertisable.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID to get campaigns from.

Query Parameters

Name

Required

Type

Description

is_active

False

boolean

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": [
    {
      "adgroups": [
        {
          "ads": [
            {
              "ad_eid": "string",
              "ad_eids": "string",
              "adgroup_eid": "string",
              "admin_status": "string",
              "advertisable_eid": "string",
              "campaign_eid": "string",
              "campaign_name": "string",
              "eid": "string",
              "is_active": true,
              "skip_approve_ad": true,
              "status": "string"
            }
          ],
          "advertisable_eid": "string",
          "attribute_targets": [
            {
              "name": "string",
              "options": [
                {
                  "name": "string",
                  "target": true
                }
              ]
            }
          ],
          "attribute_targets_segment": "string",
          "audience": {
            "adgroup_eid": "string",
            "created_at": "string",
            "eid": "string",
            "size": 0,
            "source_segment_eid": "string",
            "target_segment_eid": "string",
            "updated_at": "string"
          },
          "auto_audience": true,
          "auto_geo_targets": true,
          "campaign_eid": "string",
          "created_at": "string",
          "device_targets": {},
          "eid": "string",
          "geo_targets": [
            {
              "city": {
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "name_localized": "string",
                "region_code": "string"
              },
              "country": {
                "code": "string",
                "country": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "server_id": 0
              },
              "geo_eid": "string",
              "geo_type": "string",
              "metro": {
                "boundaries": "string",
                "country": "string",
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "server_id": 0
              },
              "name": "string",
              "operation": "string",
              "postal_code": {
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string"
              },
              "region": {
                "country": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": "string",
                "is_facebook_target": true,
                "name": "string",
                "name_localized": "string",
                "region": "string"
              }
            }
          ],
          "is_active": true,
          "name": "string",
          "status": "string",
          "updated_at": "string"
        }
      ],
      "admin_notes": "string",
      "admin_status": "string",
      "advertisable_eid": "string",
      "contextual_targeting_categories": [
        {
          "category_id": 0,
          "category_name": "string"
        }
      ],
      "created_at": "string",
      "currency_code": "string",
      "eid": "string",
      "end_date": "string",
      "frequency_cap": 0,
      "is_active": true,
      "kpi_goal": 0.0,
      "kpi_metric": "string",
      "name": "string",
      "source": "string",
      "start_date": "string",
      "status": "string",
      "targeting_type": "string",
      "updated_at": "string",
      "vcpc": 0.0,
      "vcpx": 0.0,
      "weekly_budget": "string"
    }
  ]
}
Schema
Type

object

results
Type

array of items

POST /prospecting/api/v2/advertisables/(adv)/campaigns

Create a campaign for the specified advertisable.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID to create the campaign for.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "admin_notes": "string",
  "admin_status": "string",
  "ads": "string",
  "campaign_strategy": "string",
  "contextual_targeting_categories": [
    {
      "category_id": 0,
      "category_name": "string",
      "event_source": "fortyniner-ui"
    }
  ],
  "currency_code": "string",
  "end_date": "string",
  "event_source": "fortyniner-ui",
  "frequency_cap": 0,
  "is_active": true,
  "kpi_goal": 0.0,
  "kpi_metric": "string",
  "name": "string",
  "source": "49er",
  "start_date": "string",
  "targeting_type": "lookalike",
  "user_status": "string",
  "vcpc": 0.0,
  "vcpx": 0.0,
  "weekly_budget": "string"
}
Schema
Type

object

admin_notes
Type

string

admin_status
Type

string

Enum

review, completed, cancelled, rejected, active, paused

ads
Type

string

campaign_strategy
Type

string

contextual_targeting_categories
Type

array of items

currency_code
Required

True

Type

string

end_date
Type

string

event_source
Type

string

Default

fortyniner-ui

frequency_cap
Type

integer

Format

int32

is_active
Type

boolean

kpi_goal
Type

number

Format

float

kpi_metric
Type

string

name
Required

True

Type

string

source
Type

string

Default

49er

start_date
Type

string

targeting_type
Type

string

Default

lookalike

Enum

contextual, attribute, lookalike

user_status
Type

string

Enum

paused, completed, active

vcpc
Type

number

Format

float

vcpx
Type

number

Format

float

weekly_budget
Required

True

Type

string

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroups": [
      {
        "ads": [
          {
            "ad_eid": "string",
            "ad_eids": "string",
            "adgroup_eid": "string",
            "admin_status": "string",
            "advertisable_eid": "string",
            "campaign_eid": "string",
            "campaign_name": "string",
            "eid": "string",
            "is_active": true,
            "skip_approve_ad": true,
            "status": "string"
          }
        ],
        "advertisable_eid": "string",
        "attribute_targets": [
          {
            "name": "string",
            "options": [
              {
                "name": "string",
                "target": true
              }
            ]
          }
        ],
        "attribute_targets_segment": "string",
        "audience": {
          "adgroup_eid": "string",
          "created_at": "string",
          "eid": "string",
          "size": 0,
          "source_segment_eid": "string",
          "target_segment_eid": "string",
          "updated_at": "string"
        },
        "auto_audience": true,
        "auto_geo_targets": true,
        "campaign_eid": "string",
        "created_at": "string",
        "device_targets": {},
        "eid": "string",
        "geo_targets": [
          {
            "city": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region_code": "string"
            },
            "country": {
              "code": "string",
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "geo_eid": "string",
            "geo_type": "string",
            "metro": {
              "boundaries": "string",
              "country": "string",
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "name": "string",
            "operation": "string",
            "postal_code": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string"
            },
            "region": {
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": "string",
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region": "string"
            }
          }
        ],
        "is_active": true,
        "name": "string",
        "status": "string",
        "updated_at": "string"
      }
    ],
    "admin_notes": "string",
    "admin_status": "string",
    "advertisable_eid": "string",
    "contextual_targeting_categories": [
      {
        "category_id": 0,
        "category_name": "string"
      }
    ],
    "created_at": "string",
    "currency_code": "string",
    "eid": "string",
    "end_date": "string",
    "frequency_cap": 0,
    "is_active": true,
    "kpi_goal": 0.0,
    "kpi_metric": "string",
    "name": "string",
    "source": "string",
    "start_date": "string",
    "status": "string",
    "targeting_type": "string",
    "updated_at": "string",
    "vcpc": 0.0,
    "vcpx": 0.0,
    "weekly_budget": "string"
  }
}
Schema
Type

object

results
Type

object

PATCH /prospecting/api/v2/advertisables/(adv)/campaigns

Change either user_status or currency_code (not both) for all campaigns belonging to the given advertisable. Completed or inactive campaigns won’t be affected when changing the user_status.budget and kpi_goal fields will be updated accordingly on each campaign when currency_code is changed.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID associated with the patched campaigns.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "currency_code": "string",
  "user_status": "string"
}
Schema
Type

object

currency_code
Type

string

user_status
Type

string

Enum

paused, completed, active

Responses:

200

Schema as JSON:

{
  "results": [
    {
      "adgroups": [
        {
          "ads": [
            {
              "ad_eid": "string",
              "ad_eids": "string",
              "adgroup_eid": "string",
              "admin_status": "string",
              "advertisable_eid": "string",
              "campaign_eid": "string",
              "campaign_name": "string",
              "eid": "string",
              "is_active": true,
              "skip_approve_ad": true,
              "status": "string"
            }
          ],
          "advertisable_eid": "string",
          "attribute_targets": [
            {
              "name": "string",
              "options": [
                {
                  "name": "string",
                  "target": true
                }
              ]
            }
          ],
          "attribute_targets_segment": "string",
          "audience": {
            "adgroup_eid": "string",
            "created_at": "string",
            "eid": "string",
            "size": 0,
            "source_segment_eid": "string",
            "target_segment_eid": "string",
            "updated_at": "string"
          },
          "auto_audience": true,
          "auto_geo_targets": true,
          "campaign_eid": "string",
          "created_at": "string",
          "device_targets": {},
          "eid": "string",
          "geo_targets": [
            {
              "city": {
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "name_localized": "string",
                "region_code": "string"
              },
              "country": {
                "code": "string",
                "country": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "server_id": 0
              },
              "geo_eid": "string",
              "geo_type": "string",
              "metro": {
                "boundaries": "string",
                "country": "string",
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string",
                "server_id": 0
              },
              "name": "string",
              "operation": "string",
              "postal_code": {
                "country_code": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": 0,
                "is_facebook_target": true,
                "name": "string"
              },
              "region": {
                "country": "string",
                "eid": "string",
                "geo_type": "string",
                "identifier": "string",
                "is_facebook_target": true,
                "name": "string",
                "name_localized": "string",
                "region": "string"
              }
            }
          ],
          "is_active": true,
          "name": "string",
          "status": "string",
          "updated_at": "string"
        }
      ],
      "admin_notes": "string",
      "admin_status": "string",
      "advertisable_eid": "string",
      "contextual_targeting_categories": [
        {
          "category_id": 0,
          "category_name": "string"
        }
      ],
      "created_at": "string",
      "currency_code": "string",
      "eid": "string",
      "end_date": "string",
      "frequency_cap": 0,
      "is_active": true,
      "kpi_goal": 0.0,
      "kpi_metric": "string",
      "name": "string",
      "source": "string",
      "start_date": "string",
      "status": "string",
      "targeting_type": "string",
      "updated_at": "string",
      "vcpc": 0.0,
      "vcpx": 0.0,
      "weekly_budget": "string"
    }
  ]
}
Schema
Type

object

results
Type

array of items

GET /prospecting/api/v2/advertisables/(adv)/settings

Get advertisable settings.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID to get settings for.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "advertisable": "string",
    "ctc_weight": 1.0,
    "ctc_window": 30,
    "vtc_weight": 1.0,
    "vtc_window": 30
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/advertisables/(adv)/settings

Edit advertisable settings.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID to edit settings for.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "ctc_window": 0,
  "event_source": "fortyniner-ui",
  "vtc_window": 0
}
Schema
Type

object

ctc_window

Click-through conversion window.

Type

integer

Format

int32

event_source
Type

string

Default

fortyniner-ui

vtc_window

View-through conversion window.

Type

integer

Format

int32

Responses:

200

Schema as JSON:

{
  "results": {
    "advertisable": "string",
    "ctc_weight": 1.0,
    "ctc_window": 30,
    "vtc_weight": 1.0,
    "vtc_window": 30
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/advertisables/(adv)/valid-segments

Returns the list of segment EIDs that can be used to create a Prospecting audience.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID to get segments from.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "advertisable_eid": "string",
    "valid_segment_eids": [
      "string"
    ]
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/attribute_names/(adv)

Returns the full set of available per-source attribute data

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{}
Schema
Type

object

GET /prospecting/api/v2/attribute_names/(adv)/sources

Returns a list of strings containing the NAMEs of theattribute sources

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{}
Schema
Type

object

GET /prospecting/api/v2/attribute_names/(adv)/(name)

Returns all information about the NAME’d attribute source, if the advertisable may access it.

Parameters:

Path Parameters

Name

Required

Type

Description

adv

True

string

Advertisable EID

name

True

string

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{}
Schema
Type

object

GET /prospecting/api/v2/audiences/(audience)

Retrieve an audience with the specified EID.

Parameters:

Path Parameters

Name

Required

Type

Description

audience

True

string

Audience EID to get.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "size": 0,
    "source_segment_eid": "string",
    "target_segment_eid": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/audiences/(audience)

Edit audience by its EID.

Parameters:

Path Parameters

Name

Required

Type

Description

audience

True

string

Audience EID to edit.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "size": 0
}
Schema
Type

object

size
Type

integer

Format

int32

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "size": 0,
    "source_segment_eid": "string",
    "target_segment_eid": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/campaigns/(campaign)

Retrieve a campaign with the specified EID.

Parameters:

Path Parameters

Name

Required

Type

Description

campaign

True

string

Campaign EID to get.

Query Parameters

Name

Required

Type

Description

event_source

False

string

Default: fortyniner-ui.

active_adgroups_only

False

boolean

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroups": [
      {
        "ads": [
          {
            "ad_eid": "string",
            "ad_eids": "string",
            "adgroup_eid": "string",
            "admin_status": "string",
            "advertisable_eid": "string",
            "campaign_eid": "string",
            "campaign_name": "string",
            "eid": "string",
            "is_active": true,
            "skip_approve_ad": true,
            "status": "string"
          }
        ],
        "advertisable_eid": "string",
        "attribute_targets": [
          {
            "name": "string",
            "options": [
              {
                "name": "string",
                "target": true
              }
            ]
          }
        ],
        "attribute_targets_segment": "string",
        "audience": {
          "adgroup_eid": "string",
          "created_at": "string",
          "eid": "string",
          "size": 0,
          "source_segment_eid": "string",
          "target_segment_eid": "string",
          "updated_at": "string"
        },
        "auto_audience": true,
        "auto_geo_targets": true,
        "campaign_eid": "string",
        "created_at": "string",
        "device_targets": {},
        "eid": "string",
        "geo_targets": [
          {
            "city": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region_code": "string"
            },
            "country": {
              "code": "string",
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "geo_eid": "string",
            "geo_type": "string",
            "metro": {
              "boundaries": "string",
              "country": "string",
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "name": "string",
            "operation": "string",
            "postal_code": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string"
            },
            "region": {
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": "string",
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region": "string"
            }
          }
        ],
        "is_active": true,
        "name": "string",
        "status": "string",
        "updated_at": "string"
      }
    ],
    "admin_notes": "string",
    "admin_status": "string",
    "advertisable_eid": "string",
    "contextual_targeting_categories": [
      {
        "category_id": 0,
        "category_name": "string"
      }
    ],
    "created_at": "string",
    "currency_code": "string",
    "eid": "string",
    "end_date": "string",
    "frequency_cap": 0,
    "is_active": true,
    "kpi_goal": 0.0,
    "kpi_metric": "string",
    "name": "string",
    "source": "string",
    "start_date": "string",
    "status": "string",
    "targeting_type": "string",
    "updated_at": "string",
    "vcpc": 0.0,
    "vcpx": 0.0,
    "weekly_budget": "string"
  }
}
Schema
Type

object

results
Type

object

POST /prospecting/api/v2/campaigns/(campaign)

Edit a campaign with the specified EID.

Parameters:

Path Parameters

Name

Required

Type

Description

campaign

True

string

Campaign EID to edit.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "admin_notes": "string",
  "admin_status": "string",
  "contextual_targeting_categories": [
    {
      "category_id": 0,
      "category_name": "string",
      "event_source": "fortyniner-ui"
    }
  ],
  "currency_code": "string",
  "end_date": "string",
  "event_source": "fortyniner-ui",
  "frequency_cap": 0,
  "is_active": true,
  "kpi_goal": 0.0,
  "kpi_metric": "string",
  "name": "string",
  "source": "49er",
  "start_date": "string",
  "targeting_type": "lookalike",
  "user_status": "string",
  "vcpc": 0.0,
  "vcpx": 0.0,
  "weekly_budget": "string"
}
Schema
Type

object

admin_notes
Type

string

admin_status
Type

string

Enum

review, completed, cancelled, rejected, active, paused

contextual_targeting_categories
Type

array of items

currency_code
Type

string

end_date
Type

string

event_source
Type

string

Default

fortyniner-ui

frequency_cap
Type

integer

Format

int32

is_active
Type

boolean

kpi_goal
Type

number

Format

float

kpi_metric
Type

string

name
Type

string

source
Type

string

Default

49er

start_date
Type

string

targeting_type
Type

string

Default

lookalike

Enum

contextual, attribute, lookalike

user_status
Type

string

Enum

paused, completed, active

vcpc
Type

number

Format

float

vcpx
Type

number

Format

float

weekly_budget
Type

string

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroups": [
      {
        "ads": [
          {
            "ad_eid": "string",
            "ad_eids": "string",
            "adgroup_eid": "string",
            "admin_status": "string",
            "advertisable_eid": "string",
            "campaign_eid": "string",
            "campaign_name": "string",
            "eid": "string",
            "is_active": true,
            "skip_approve_ad": true,
            "status": "string"
          }
        ],
        "advertisable_eid": "string",
        "attribute_targets": [
          {
            "name": "string",
            "options": [
              {
                "name": "string",
                "target": true
              }
            ]
          }
        ],
        "attribute_targets_segment": "string",
        "audience": {
          "adgroup_eid": "string",
          "created_at": "string",
          "eid": "string",
          "size": 0,
          "source_segment_eid": "string",
          "target_segment_eid": "string",
          "updated_at": "string"
        },
        "auto_audience": true,
        "auto_geo_targets": true,
        "campaign_eid": "string",
        "created_at": "string",
        "device_targets": {},
        "eid": "string",
        "geo_targets": [
          {
            "city": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region_code": "string"
            },
            "country": {
              "code": "string",
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "geo_eid": "string",
            "geo_type": "string",
            "metro": {
              "boundaries": "string",
              "country": "string",
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string",
              "server_id": 0
            },
            "name": "string",
            "operation": "string",
            "postal_code": {
              "country_code": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": 0,
              "is_facebook_target": true,
              "name": "string"
            },
            "region": {
              "country": "string",
              "eid": "string",
              "geo_type": "string",
              "identifier": "string",
              "is_facebook_target": true,
              "name": "string",
              "name_localized": "string",
              "region": "string"
            }
          }
        ],
        "is_active": true,
        "name": "string",
        "status": "string",
        "updated_at": "string"
      }
    ],
    "admin_notes": "string",
    "admin_status": "string",
    "advertisable_eid": "string",
    "contextual_targeting_categories": [
      {
        "category_id": 0,
        "category_name": "string"
      }
    ],
    "created_at": "string",
    "currency_code": "string",
    "eid": "string",
    "end_date": "string",
    "frequency_cap": 0,
    "is_active": true,
    "kpi_goal": 0.0,
    "kpi_metric": "string",
    "name": "string",
    "source": "string",
    "start_date": "string",
    "status": "string",
    "targeting_type": "string",
    "updated_at": "string",
    "vcpc": 0.0,
    "vcpx": 0.0,
    "weekly_budget": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/campaigns/(campaign)/adgroups

Get AdGroups that belong to given campaign.

Parameters:

Path Parameters

Name

Required

Type

Description

campaign

True

string

Campaign EID to get AdGroups from.

Query Parameters

Name

Required

Type

Description

is_active

False

boolean

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": [
    {
      "ads": [
        {
          "ad_eid": "string",
          "ad_eids": "string",
          "adgroup_eid": "string",
          "admin_status": "string",
          "advertisable_eid": "string",
          "campaign_eid": "string",
          "campaign_name": "string",
          "eid": "string",
          "is_active": true,
          "skip_approve_ad": true,
          "status": "string"
        }
      ],
      "advertisable_eid": "string",
      "attribute_targets": [
        {
          "name": "string",
          "options": [
            {
              "name": "string",
              "target": true
            }
          ]
        }
      ],
      "attribute_targets_segment": "string",
      "audience": {
        "adgroup_eid": "string",
        "created_at": "string",
        "eid": "string",
        "size": 0,
        "source_segment_eid": "string",
        "target_segment_eid": "string",
        "updated_at": "string"
      },
      "auto_audience": true,
      "auto_geo_targets": true,
      "campaign_eid": "string",
      "created_at": "string",
      "device_targets": {},
      "eid": "string",
      "geo_targets": [
        {
          "city": {
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "name_localized": "string",
            "region_code": "string"
          },
          "country": {
            "code": "string",
            "country": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "server_id": 0
          },
          "geo_eid": "string",
          "geo_type": "string",
          "metro": {
            "boundaries": "string",
            "country": "string",
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "server_id": 0
          },
          "name": "string",
          "operation": "string",
          "postal_code": {
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string"
          },
          "region": {
            "country": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": "string",
            "is_facebook_target": true,
            "name": "string",
            "name_localized": "string",
            "region": "string"
          }
        }
      ],
      "is_active": true,
      "name": "string",
      "status": "string",
      "updated_at": "string"
    }
  ]
}
Schema
Type

object

results
Type

array of items

POST /prospecting/api/v2/campaigns/(campaign)/adgroups

Create an AdGroup for the given campaign.

Parameters:

Path Parameters

Name

Required

Type

Description

campaign

True

string

Campaign EID to add AdGroup to.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "ads": [
    {
      "ad_eid": "string",
      "ad_eids": "string",
      "admin_status": "string",
      "event_source": "fortyniner-ui",
      "is_active": true,
      "skip_approve_ad": true,
      "user_status": "string"
    }
  ],
  "attribute_targets": [
    {
      "event_source": "fortyniner-ui",
      "name": "string",
      "options": [
        {
          "event_source": "fortyniner-ui",
          "name": "string",
          "target": true
        }
      ]
    }
  ],
  "attribute_targets_segment": "string",
  "auto_audience": true,
  "auto_geo_targets": true,
  "device_targets": {},
  "event_source": "fortyniner-ui",
  "geo_targets": [
    {
      "eid": "string",
      "event_source": "fortyniner-ui",
      "geo_type": "string",
      "operation": "string"
    }
  ],
  "is_active": true,
  "name": "string",
  "segments": [
    {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "event_source": "fortyniner-ui",
      "is_active": true,
      "is_negative": true,
      "segment_eid": "string",
      "segment_targeting_type": "string",
      "updated_at": "string"
    }
  ],
  "user_status": "string"
}
Schema
Type

object

ads
Type

array of items

attribute_targets
Type

array of items

attribute_targets_segment
Type

string

auto_audience
Type

boolean

auto_geo_targets
Type

boolean

device_targets
Type

object

event_source
Type

string

Default

fortyniner-ui

geo_targets
Type

array of items

is_active
Type

boolean

name
Type

string

segments
Type

array of items

user_status
Type

string

Enum

paused, active

Responses:

200

Schema as JSON:

{
  "results": {
    "ads": [
      {
        "ad_eid": "string",
        "ad_eids": "string",
        "adgroup_eid": "string",
        "admin_status": "string",
        "advertisable_eid": "string",
        "campaign_eid": "string",
        "campaign_name": "string",
        "eid": "string",
        "is_active": true,
        "skip_approve_ad": true,
        "status": "string"
      }
    ],
    "advertisable_eid": "string",
    "attribute_targets": [
      {
        "name": "string",
        "options": [
          {
            "name": "string",
            "target": true
          }
        ]
      }
    ],
    "attribute_targets_segment": "string",
    "audience": {
      "adgroup_eid": "string",
      "created_at": "string",
      "eid": "string",
      "size": 0,
      "source_segment_eid": "string",
      "target_segment_eid": "string",
      "updated_at": "string"
    },
    "auto_audience": true,
    "auto_geo_targets": true,
    "campaign_eid": "string",
    "created_at": "string",
    "device_targets": {},
    "eid": "string",
    "geo_targets": [
      {
        "city": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region_code": "string"
        },
        "country": {
          "code": "string",
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "geo_eid": "string",
        "geo_type": "string",
        "metro": {
          "boundaries": "string",
          "country": "string",
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string",
          "server_id": 0
        },
        "name": "string",
        "operation": "string",
        "postal_code": {
          "country_code": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": 0,
          "is_facebook_target": true,
          "name": "string"
        },
        "region": {
          "country": "string",
          "eid": "string",
          "geo_type": "string",
          "identifier": "string",
          "is_facebook_target": true,
          "name": "string",
          "name_localized": "string",
          "region": "string"
        }
      }
    ],
    "is_active": true,
    "name": "string",
    "status": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

GET /prospecting/api/v2/campaigns/(campaign)/geo-targets

Retrieve GeoTargets for the specified Campaign.

Parameters:

Path Parameters

Name

Required

Type

Description

campaign

True

string

Campaign EID to get GeoTargets from.

Query Parameters

Name

Required

Type

Description

active_adgroups_only

False

boolean

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Responses:

200

Schema as JSON:

{
  "results": [
    {
      "adgroup": "string",
      "geotargets": [
        {
          "city": {
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "name_localized": "string",
            "region_code": "string"
          },
          "country": {
            "code": "string",
            "country": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "server_id": 0
          },
          "geo_eid": "string",
          "geo_type": "string",
          "metro": {
            "boundaries": "string",
            "country": "string",
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string",
            "server_id": 0
          },
          "name": "string",
          "operation": "string",
          "postal_code": {
            "country_code": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": 0,
            "is_facebook_target": true,
            "name": "string"
          },
          "region": {
            "country": "string",
            "eid": "string",
            "geo_type": "string",
            "identifier": "string",
            "is_facebook_target": true,
            "name": "string",
            "name_localized": "string",
            "region": "string"
          }
        }
      ]
    }
  ]
}
Schema
Type

object

results
Type

array of items

PUT /prospecting/api/v2/flights/(flight)

Edit a Flight.

Parameters:

Path Parameters

Name

Required

Type

Description

flight

True

string

Flight EID to edit.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "end_date": "string",
  "event_source": "fortyniner-ui",
  "start_date": "string"
}
Schema
Type

object

end_date

Flight end date.

Type

string

event_source
Type

string

Default

fortyniner-ui

start_date

Flight start date.

Type

string

Responses:

200

Flight edited successfully.

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "end_date": "string",
    "start_date": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object

400

The Flight was not edited.

  • Your Flight might be missing start/end dates.

  • The start date might be greater than the end date.

  • Your Flight might be overlapping with another of the adgroup’s Flights.

Schema as JSON:

{
  "code": 0,
  "message": "string"
}
Schema
Type

object

code

HTTP error code.

Type

integer

Format

int32

message

String, list, or dictionary of error messages. If a dictionary, the keys will be field names and the values will be lists of messages.

Type

string

DELETE /prospecting/api/v2/flights/(flight)

Delete a Flight.

Parameters:

Path Parameters

Name

Required

Type

Description

flight

True

string

Flight EID to delete.

Query Parameters

Name

Required

Type

Description

apikey

False

string

Required if using HTTP Basic Authentication. The value is the Client ID you received when you registered your application on the NextRoll Developer site

Schema for request body:

{
  "event_source": "fortyniner-ui"
}
Schema
Type

object

event_source
Type

string

Default

fortyniner-ui

Responses:

200

Schema as JSON:

{
  "results": {
    "adgroup_eid": "string",
    "created_at": "string",
    "eid": "string",
    "end_date": "string",
    "start_date": "string",
    "updated_at": "string"
  }
}
Schema
Type

object

results
Type

object