personalizer.io Documentation

Help Page Home

GET v1/TopPicks?limit={limit}&fields={fields}&age={age}&gender={gender}&relationshipStatus={relationshipStatus}&homeTown={homeTown}&location={location}&freeText={freeText}&interestKeywords={interestKeywords}&trackerReference={trackerReference}

Returns the Top Picks items for the current User or the supplied profile information.

Request Information

URI Parameters

NameTypeDescriptionComments
limit integer

Number of results requested.

Optional - Default: 50

fields string

Comma-separated list of fields to include in the response.

Optional - Default: "Identifier"

age integer

Age for which Top Picks is requested.

Optional - Default: Unspecified - Use of this parameter will completely override the current authorized user's profile information

gender Gender

Age for which Top Picks is requested.

Optional - Default: Unspecified - Use of this parameter will completely override the current authorized user's profile information

relationshipStatus RelationshipStatus

Relationship Status for which Top Picks is requested.

Optional - Default: Unspecified - Use of this parameter will completely override the current authorized user's profile information

homeTown string

- Use of this parameter will completely override the current authorized user's profile information] Home Town for which Top Picks is requested.

Optional - Default: Unspecified

location string

- Use of this parameter will completely override the current authorized user's profile information] Location for which Top Picks is requested.

Optional - Default: Unspecified

freeText string

- Use of this parameter will completely override the current authorized user's profile information] Descriptive or tag-based (e.g. comma-separated) text about the person for which Top Picks is requested.

Optional - Default: Unspecified

interestKeywords string

- Use of this parameter will completely override the current authorized user's profile information] Comma-separated list of Intrest Keywords for which Top Picks is requested.

Optional - Default: Unspecified

host HostPage

- Host Page on which the recommendations will be rendered.

Optional - Default: Dynamic

trackerReference string

Additional tracker reference data.

Optional

Body Parameters

None.

Response Information

Resource Description

A list of top picked items.

Collection of Item
NameTypeDescriptionComments
Identifier string

Title string

Vendor string

ItemType string

Price decimal number

OriginalPrice decimal number

DisplayUrl string

Description string

ImageUrl string

Prevalence integer

CollectionPrevalence integer

PopularityIndex integer

TrendingIndex integer

Tags string

Active boolean

Collections Collection of string

UpdateDate date

Response Formats

application/json, text/json

Sample:
[
  {
    "Identifier": "sample string 1",
    "Title": "T-Shirt",
    "Vendor": "Nike",
    "Description": "Sample T-Shirt",
    "Prevalence": 0,
    "PopularityIndex": 2,
    "Tags": "Tee,Shirt,T-Shirt"
  },
  {
    "Identifier": "sample string 2",
    "Title": "Shoe",
    "Vendor": "Adidas",
    "Description": "Sample Shoe",
    "Prevalence": 0,
    "PopularityIndex": 1,
    "Tags": "Footwear,Shoe"
  }
]