Client Video Impression End Points

Owned by Brenton Rose
Last updated: Feb 16, 2023 by Berto Torres
2 min read

Advertisers

 Edit

Video Templates

  • Endpoint: https://api.hootinteractive.net/cli_api/video_templates/<adv_id>

    • /<adv_id> is optional. If present it filters the video templates to only show the ones belonging to that advertiser.

  • Method: GET

  • Security: HTTPS Basic Auth

    • User: <client_id>

    • Pass: <token>

  • Responses:

    • 500 + Error message in case of error

    • 404 If <adv_id> present and does not exist

    • 200 OK + List of Video Templates

 Edit

Ad Versions

  • Endpoint: https://api.hootinteractive.net/cli_api/adversions/<adv_id>

    • /<adv_id> is optional. If present it filters the Ad Versions to only show the ones belonging to that advertiser.

  • Method: GET

  • Security: HTTPS Basic Auth

    • User: <client_id>

    • Pass: <token>

  • Responses:

    • 500 + Error message in case of error

    • 404 If <adv_id> present and does not exist

    • 200 OK + List of Ad Versions

 Edit

Video

  • Endpoint: //api.hootinteractive.net/cli_api/videos/<adv_id>/<adversion_id>

    • /<adv_id> is optional. If present it filters the Videos to only show the ones belonging to that advertiser.

    • /<adversion_id> is optional. If present it filters the Videos to only show the ones belonging to that ad version.

  • Method: GET

  • Security: HTTPS Basic Auth

    • User: <client_id>

    • Pass: <token>

  • Request Body:

Responses:

  •  

    • 500 + Error message in case of error

    • 400 Bad Request

      • If any of start_date or end_date is not present

      • If any of start_date or end_date don't comply with the specified format

      • If the date range is greater than 31 days

    • 404 Not Found:

      • If <adv_id> does not exist

      • If <adversion_id> does not exist

    • 200 OK + List of Videos with the products that were present in them