Skip to main content
Domain Lists

Managing domain lists

OddBytes avatar
Written by OddBytes
Updated over 2 years ago

Get domain lists

To get domain lists, use GET method and DomainLists service:

GET Method

curl -u username:password -X GET \
https://platform.oddbytes.com/api/v1/15110/DomainLists

Create domain lists

To create a domain list, use POST method and DomainLists service:

POST Method

curl -u username:password -X POST --data '{"listName":"new_list_name"}' https://platform.oddbytes.com/api/v1/15110/DomainLists

Edit domain lists name

To edit domain list, use PUT method and DomainLists service:

PUT Method

curl -u username:password -X PUT \
--data '{"listName":"some_list_name". "listID":"123"}' \
https://platform.oddbytes.com/api/v1/15110/DomainLists

Add keywords/domains into domains lists

To add domains into a domain list, use POST method and DomainKeywords service:

POST Method

curl -u username:password -X POST \
--data '{"listIDs":["123", "456"], "keywords":["test1.com", "test2.com"]}' \
https://platform.oddbytes.com/api/v1/15110/DomainKeywords

Remove keywords/domains from domain lists

To remove domains from domain list, use DELETE method and DomainKeywords service:

POST Method

curl -u username:password -X DELETE \
--data '{"listIDs":["123", "456"], "keywords":["test1.com", "test2.com"]}' \
https://platform.oddbytes.com/api/v1/15110/DomainKeywords

Assign domain lists

To assign domain list, use POST method and DomainListsAssign service:

POST Method

curl -u username:password -X POST \
--data '{"listIDs":["123", "456"], "creativeType":"ANY|POPUP|TEXTLINK", "targeting":"INCLUDED|EXCLUDED", "itemLevel":"accounts|campaigns|creatives", "itemIDs":["123", "456"], "actionType":"APPEND|OVERRIDE"}' \
https://platform.oddbytes.com/api/v1/15110/DomainListsAssign

Note: itemIDs is used only if assign is on campaign/creative level which represent campaigns/creatives IDs.

Delete assignment from domain lists

To delete an assignment from domain list, use DELETE method and DomainListsAssign service:

DELETE Method

curl -u username:password -X DELETE \
--data '{"accountId":"15110", "itemLevel":"accounts|campaigns|creatives", "campaignId":"123", "creativeId":"456", "targeting":"INCLUDED|EXCLUDED", "creativeType":"ANY|POPUP|TEXTLINK", "listId":"123]"}' \
https://platform.oddbytes.com/api/v1/15110/DomainListsAssign

Note: campaignId/crativeId is used only if delete is for specific campaign/creative

Example: Remove assignment from exclusion for campaign id 123456, popup creative type for list id 789

DELETE Method

curl -u username:password -X DELETE \
--data '{"accountId":"15110", "itemLevel":"campaigns", "campaignId":"123456", "targeting":"EXCLUDED", "creativeType":"POPUP", "listId":"789]"}' \
https://platform.oddbytes.com/api/v1/15110/DomainListsAssig

Did this answer your question?