Suggested-seen should be called when a user has seen a contact from their ranked addressbook – for example, in an mobile app when a user scrolls through a screen of potential people to invite.

This will help us train our rankings system to provide better results for rankings in the future.

The input is a list of entries of contacts seen, with the user-id of the current user of the app.

POST /suggested-seen

entries required list A list of the contacts that were suggested to the user – not the entire address-book.

Entries objects

user_id required string The unique ID you use internally to reference the user. This could be a string or an int.
emails required (unless phones is present) list of strings The emails of the contact who was suggested to the user. Use this key if the suggestion included emails.
phones required (unless emails is present) list of strings or ints The phone numbers of the contact who was suggested to the user. Use this key if the suggestion included phone numbers.
seen_at optional date The date and time the suggestion was seen. It defaults to the current time if not provided. This is an ISO 8601 date string or a Unix timestamp (integer). See the Dates section for details.
# Use YesGraph's Python SDK 
# https://github.com/yesgraph/python-yesgraph
from yesgraph import YesGraphAPI
api = YesGraphAPI("YOUR_SECRET_KEY")

entries = [{"user_id": "1111",
            "name":"kendall",
            "emails": ["kendall@yesgraph.com"],
            "seen_at": "2015-02-28T20:16:12+00:00"
           }]

api.post_suggested_seen(entries=entries)
curl -X POST \
    -H 'Authorization: Bearer YOUR_SECRET_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
        "entries" : 
            [{"user_id": "1111",
            "name":"kendall",
            "emails": ["kendall@yesgraph.com"],
            "phones": ["4442223333"],
            "seen_at": "2015-02-28T20:16:12+00:00"
            }]
    }' \
    https://api.yesgraph.com/v0/suggested-seen