Entities

An entity is the actual thing being advertised (product, hotel, restaurant, etc.). Entities with bids are referred to bidders in the Delivery + Collections API reference.

To get a list of all entities in an ad group, use Reports with the appropriate query parameters.

POST advertisers/{advertiserId}/entities/report will get you all the entities assigned to an advertiser.

Endpoints

Method

Path

Description

POST

member_groups/
{memberGroupId}
/entities/{entityId}
/bid_strength

This endpoint calculates a new bid strength with a given new bid for an entity.

POST

/member_groups
/{memberGroupId}
/advertisers
/{advertiserId}
/entity_registrations
/initiate

This endpoint can be used to add bidders to an account.

POST

/member_groups
/{memberGroupId}
/advertisers
/{advertiserId}
/entity_registrations
/failed
/report

This endpoint returns a report for failed instances of attempting to add bidders to an account.

Note: No body is necessary to run this endpoint.

DELETE

member_groups/{memberGroupId}
/advertisers/{advertiserId}
/entities

This endpoint deletes a list of entities from an advertiser