Ads / Custom Posts

Returns a JSON feed / wall / channel of Ads / Custom Posts that can be integrated into a widget, displayed on your website, displayed on a digital TV, queried via an API, et cetera, et cetera, and so forth.

List Ads / Custom Posts

This endpoint lists all Ads / Custom Posts

GET /ads

Request

GET /v1.2/ads

Response

[
    {
        "id": "xkql7nr4",
        "feed_id": "a2232619-9d95-430f-9956-21343838e528",
        "network_id": 3,
        "status": "paused",
        "name": "custom",
        "title": "",
        "text": "this is a text",
        "is_html": 0,
        "click_action": "goto-url",
        "position_start": 1,
        "position_repeats": true,
        "position_repeat_interval": 5,
        "image_width": 5,
        "image_height": 5,
        "url": "http://google.com",
        "created_at": "2022-02-07 04:40:30",
        "slug": "xkql7nr4",
        "network_name": "Facebook",
        "image_url": "https://curator-stage.s3.amazonaws.com/custom-post-assets/208/GimxjaMS.jpg",
        "video_url": "https://my-video-url/cool.mp4"
    },
]

Create Ads / Custom Post

This end point creates an Ad / Custom Post for a Feed.

POST /ads

Request

POST /v1.2/ads

{
    "name" : "Awesome Ad!",
    "feed_id" : "a2232619-9d95-430f-9956-21343838e528",
    "network_icon" : 1,
    "position_start" : 64,
    "position_repeats" : true,
    "position_repeat_interval" : 2,
    "network_id" : 3,
    "text" : "this is a text",
    "status" : "paused",
    "click_action" : "goto-url",
    "url" : "http://google.com",
    "image_url": "https://curator-stage.s3.amazonaws.com/custom-post-assets/208/GimxjaMS.jpg",
    "video_url": "https://my-video-url/cool.mp4"
}

Response

{
    "id": "2gq9pjnk",
    "feed_id": "a2232619-9d95-430f-9956-21343838e528",
    "network_id": 3,
    "status": "paused",
    "name": "Awesome Ad!",
    "title": "",
    "text": "this is a text",
    "is_html": 0,
    "click_action": "goto-url",
    "position_start": 64,
    "position_repeats": true,
    "position_repeat_interval": 2,
    "image_width": 5,
    "image_height": 5,
    "url": "http://google.com",
    "created_at": "2022-02-08 02:34:53",
    "feed": {
        "id": "a2232619-9d95-430f-9956-21343838e528",
        "public_key": "d926da1c-1dab-44a7-87f5-89496374c14a",
        "moderation": "post",
        "post_status": 1,
        "name": "Default feed",
        "type": "website",
        "widget_type": "Waterfall",
        "widget_theme": "sydney",
        "slug": "curator-feed",
        "widget_options": "{\"type\":\"Waterfall\"}",
        "widget_styles": "{}",
        "widget_colours": "{}",
        "widget_advanced_styles": 0,
        "colour_options": null,
        "default_image": null,
        "default_user_image": null,
        "api_id": "a2232619-9d95-430f-9956-21343838e528",
        "widget_endpoint": null,
        "debug": 0,
        "widget_version": "4.0",
        "js_loader_version": "2",
        "html_before": null,
        "html_after": null,
        "cache": 1,
        "cache_time": "5",
        "default_feed_layout_id": 644,
        "post_count": 811,
        "is_installed": 1,
        "meta": {
            "embedSource": "wordpress-plugin",
            "hasTiktokEmbed": true
        },
        "is_latest_version": false
    },
    "slug": "2gq9pjnk",
    "network_name": "Facebook",
    "image_url": "https://image-url.jpg",
    "video_url": "https://video-url.mp4"
}

Params

Param_type	Description	Required
feed_id	Feed to assign the Ad to	Yes
network_id	Network to assign the Ad. See Network	Yes
name	The name of the Ad	Yes
position_start	The position placement of the Ad	Yes
position_repeats	Whether the Ad position repeats (value: `true` OR `false`)	Yes
position_repeat_interval	The number when this Ad will repeat on every post. (Required if `position_repeats` is `true`)	Yes
text	The text of the Ad	Yes
status	`active` = the Ad will run and will be shown in the Feed, `paused` = the Ad will not run and will not be shown in the Feed.	Yes
click_action	`goto-url` = when user clicks on the Ad, it will be redirected to the URL that you specified in the `url` field. `nothing` = When the user clicks on the Ad, nothing will happen.	Yes
url	The URL that the user will be redirected when they clicked on the Ad.	Yes if `click_action` = `goto-url`
image_url	The Image URL of the Ad that is hosted by an external URL.	No
video_url	The Video URL of the Ad that is hosted by an external URL.	No

Update Ad / Custom Post

Updates an Ad / Custom Post.

POST /ads/AD_ID

Request

POST /v1.2/ads/AD_ID

{
    "name" : "Awesome Ad!",
    "feed_id" : "a2232619-9d95-430f-9956-21343838e528",
    "position_start" : 2,
    "position_repeats" : false,
    "network_id" : 5,
    "text" : "this is a text",
    "status" : "active",
    "click_action" : "goto-url",
    "url" : "http://google.com"
}

Response

{
    "id": "kg3gp13j",
    "company_id": 208,
    "feed_id": 642,
    "network_id": 5,
    "status": "active",
    "name": "Awesome Ad!",
    "title": "",
    "text": "this is a text",
    "is_html": 0,
    "click_action": "goto-url",
    "position_start": 2,
    "position_repeats": false,
    "position_repeat_interval": 3,
    "image_width": 5,
    "image_height": 5,
    "url": "http://google.com",
    "created_at": "2022-02-08 02:29:50",
    "updated_at": "2022-02-08 03:07:39",
    "deleted_at": null,
    "feed": {
        "id": "a2232619-9d95-430f-9956-21343838e528",
        "public_key": "d926da1c-1dab-44a7-87f5-89496374c14a",
        "moderation": "post",
        "post_status": 1,
        "name": "Default feed",
        "type": "website",
        "widget_type": "Waterfall",
        "widget_theme": "sydney",
        "slug": "curator-feed",
        "widget_options": "{\"type\":\"Waterfall\"}",
        "widget_styles": "{}",
        "widget_colours": "{}",
        "widget_advanced_styles": 0,
        "colour_options": null,
        "default_image": null,
        "default_user_image": null,
        "api_id": "a2232619-9d95-430f-9956-21343838e528",
        "widget_endpoint": null,
        "debug": 0,
        "widget_version": "4.0",
        "js_loader_version": "2",
        "html_before": null,
        "html_after": null,
        "cache": 1,
        "cache_time": "5",
        "default_feed_layout_id": 644,
        "post_count": 812,
        "is_installed": 1,
        "meta": {
            "embedSource": "wordpress-plugin",
            "hasTiktokEmbed": true
        },
        "is_latest_version": false
    },
    "slug": "kg3gp13j",
    "network_name": "Google Plus",
    "image_url": "",
    "video_url": ""
}

Params

Param_type	Description	Required
ad_id	ID of Ad to update	Yes
feed_id	Feed to assign the Ad to	Yes
network_id	Network to assign the Ad. See Network	Yes
name	The name of the Ad	Yes
position_start	The position placement of the Ad	Yes
position_repeats	Whether the Ad position repeats (value: `true` OR `false`)	Yes
position_repeat_interval	The number when this Ad will repeat on every post. (Required if `position_repeats` is `true`)	Yes
text	The text of the Ad	Yes
status	`active` = the Ad will run and be shown in the Feed, `paused` = the Ad will not run and will not be shown in the Feed.	Yes
click_action	`goto-url` = when user clicks on the Ad, it will be redirected to the URL that you specified in the `url` field. `nothing` = When the user clicks on the Ad, nothing will happen.	Yes
url	The URL that the user will be redirected when they clicked on the Ad.	Yes if `click_action` = `goto-url`
image_url	The Image URL of the Ad that is hosted by an external URL.	No
video_url	The Video URL of the Ad that is hosted by an external URL.	No

Delete Ad / Custom Post

Delete an Ad / Custom Post.

DELETE /ads/AD_ID

Request

DELETE /v1.2/ads/AD_ID

Response

{
    "success": true,
    "feed": {
        "id": "a2232619-9d95-430f-9956-21343838e528",
        "public_key": "d926da1c-1dab-44a7-87f5-89496374c14a",
        "moderation": "post",
        "post_status": 1,
        "name": "Default feed",
        "type": "website",
        "widget_type": "Waterfall",
        "widget_theme": "sydney",
        "slug": "curator-feed",
        "widget_options": "{\"type\":\"Waterfall\"}",
        "widget_styles": "{}",
        "widget_colours": "{}",
        "widget_advanced_styles": 0,
        "colour_options": null,
        "default_image": null,
        "default_user_image": null,
        "api_id": "a2232619-9d95-430f-9956-21343838e528",
        "widget_endpoint": null,
        "debug": 0,
        "widget_version": "4.0",
        "js_loader_version": "2",
        "html_before": null,
        "html_after": null,
        "cache": 1,
        "cache_time": "5",
        "default_feed_layout_id": 644,
        "post_count": 811,
        "is_installed": 1,
        "meta": {
            "embedSource": "wordpress-plugin",
            "hasTiktokEmbed": true
        },
        "is_latest_version": false
    }
}

Params

Param	Description	Required
AD_ID	Id of Ad to delete	Yes