Skip to main content

Personalization (PID)

Talroo can personalize job results. New signals usually show up in search within a couple of minutes.

To use it: pass pid (Private ID) with the Search API, so we can tie queries back to the same person without using PII.

api.jobs2careers.com/api/search.php?id=9999&pass=ABCDEF&ip=X&q=X&l=X&pid=1234
Important

The old personalization parameter, uid, is deprecated. Use pid.

pid is API-only. It does not apply to XML feeds.

How to Set It

  • Use the same pid for the same returning user
  • Give each user their own value
  • Don't use a single site-wide ID, and don't mint a new pid on every query

Use a unique, non-PII identifier, such as a salted hash of an internal account ID.

Example:

sha256(<salt> + <account_id>) = sha256("hello_world_1234567890")
Privacy Notice

Don't hash emails. Email hashes are treated as personally identifiable information (PII).

For how to put pid on the request, see API Integration.