Person Search API

Person Lookup API: http://core.tdar.org/lookup/person

To search for collections in tDAR

Requests:

To make a request to the collection lookup API, you will need a "title."

Parameters:

  • term: the term to search for (searches name, email, institution and other  fields).
  • firstName: the Person's first name
  • lastName: the Person's last name
  • institution: the name of the institution related to the person
  • email: is there a person / user that matches the email
  • registered: true / false whether the user is registered or not
  • startRecord: the first record to display (for pagination)
  • recordsPerPage: the number of records to return
  • sortField: how to sort the results, default is relevance.

Response:

The response will include the following information:

  1. A list of "items" that contains the name, id, and a full URL for the collection.
  2. A status object containing the number of results, records per page, and sorting options.

Example:

URL: http://core.tdar.org/lookup/person?term=ASU

A sample search for the term "ASU". Note, the results will be different dependent on whether you're logged in or not

 

{
    "people": [
        {
            "dateCreated": "2011-03-25T00:00:00-07:00",
            "url": null,
            "lastName": "Hernanderz",
            "firstName": "Adan",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Adan Hernanderz",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11939/adan-hernanderz",
            "id": 11939,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Lee",
            "firstName": "Allen",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Allen Lee",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/1/allen-lee",
            "id": 1,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-03-24T00:00:00-07:00",
            "url": null,
            "lastName": "Lack",
            "firstName": "Andrew",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Andrew Lack",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11937/andrew-lack",
            "id": 11937,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-02-24T00:00:00-07:00",
            "url": "",
            "lastName": "Watkins",
            "firstName": "Chris",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "asu",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11017/asu",
                "id": 11017,
                "status": "ACTIVE",
                "name": "asu"
            },
            "properName": "Chris Watkins",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11876/chris-watkins",
            "id": 11876,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Szuter",
            "firstName": "Christine",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Christine Szuter",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8039/christine-szuter",
            "id": 8039,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-03-18T00:00:00-07:00",
            "url": null,
            "lastName": "Bonanni",
            "firstName": "Domenico",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Domenico Bonanni",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11921/domenico-bonanni",
            "id": 11921,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-04-07T00:00:00-07:00",
            "url": null,
            "lastName": "Sotelo",
            "firstName": "Elenia",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Elenia Sotelo",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11988/elenia-sotelo",
            "id": 11988,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Cao",
            "firstName": "Huiping",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Huiping Cao",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/2/huiping-cao",
            "id": 2,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-03-24T00:00:00-07:00",
            "url": null,
            "lastName": "Clark",
            "firstName": "Jacob",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Jacob Clark",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11938/jacob-clark",
            "id": 11938,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2016-04-06T11:39:21-07:00",
            "url": null,
            "lastName": "Navarro",
            "firstName": "Joe",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Joe Navarro",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/166732/joe-navarro",
            "id": 166732,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Candan",
            "firstName": "K. Selcuk",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "asu",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11017/asu",
                "id": 11017,
                "status": "ACTIVE",
                "name": "asu"
            },
            "properName": "K. Selcuk Candan",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8067/k-selcuk-candan",
            "id": 8067,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2012-02-14T00:00:00-07:00",
            "url": null,
            "lastName": "Swantek",
            "firstName": "Laura",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Laura Swantek",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/137075/laura-swantek",
            "id": 137075,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Hatch",
            "firstName": "Mallorie",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Mallorie Hatch",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/38/mallorie-hatch",
            "id": 38,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Cordial",
            "firstName": "Matt",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Matt Cordial",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8002/matt-cordial",
            "id": 8002,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-02-08T00:00:00-07:00",
            "url": null,
            "lastName": "Kruse-Peeples",
            "firstName": "Melissa",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Melissa Kruse-Peeples",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11766/melissa-kruse-peeples",
            "id": 11766,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2012-01-09T00:00:00-07:00",
            "url": null,
            "lastName": "Merrill",
            "firstName": "Michael",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Michael Merrill",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/136795/michael-merrill",
            "id": 136795,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-02-11T00:00:00-07:00",
            "url": null,
            "lastName": "O'Hara",
            "firstName": "Michael",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Michael O'Hara",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11827/michael-ohara",
            "id": 11827,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Nagarkar",
            "firstName": "Parth",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Parth Nagarkar",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8020/parth-nagarkar",
            "id": 8020,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2012-02-27T00:00:00-07:00",
            "url": null,
            "lastName": "Morin",
            "firstName": "Robyn",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Robyn Morin",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/137248/robyn-morin",
            "id": 137248,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-04-06T00:00:00-07:00",
            "url": null,
            "lastName": "Rosas",
            "firstName": "Salvador",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "asu",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11017/asu",
                "id": 11017,
                "status": "ACTIVE",
                "name": "asu"
            },
            "properName": "Salvador Rosas",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11983/salvador-rosas",
            "id": 11983,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-04-04T00:00:00-07:00",
            "url": null,
            "lastName": "Striker",
            "firstName": "Sarah",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Sarah Striker",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11971/sarah-striker",
            "id": 11971,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Manney",
            "firstName": "Shelby",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Shelby Manney",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8019/shelby-manney",
            "id": 8019,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Manney",
            "firstName": "Shelby",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Shelby Manney",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/8018/shelby-manney",
            "id": 8018,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2011-02-19T00:00:00-07:00",
            "url": null,
            "lastName": "Wang",
            "firstName": "Shu",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "asu",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11017/asu",
                "id": 11017,
                "status": "ACTIVE",
                "name": "asu"
            },
            "properName": "Shu Wang",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/11855/shu-wang",
            "id": 11855,
            "status": "ACTIVE"
        },
        {
            "dateCreated": "2015-10-30T17:22:26-07:00",
            "url": null,
            "lastName": "Na",
            "firstName": "Sim",
            "email": null,
            "institution": {
                "dateCreated": "2015-10-30T17:22:26-07:00",
                "url": null,
                "properName": "ASU",
                "urlNamespace": "browse/creators",
                "institutionName": null,
                "detailUrl": "/browse/creators/11006/asu",
                "id": 11006,
                "status": "DUPLICATE",
                "name": "ASU"
            },
            "properName": "Sim Na",
            "urlNamespace": "browse/creators",
            "detailUrl": "/browse/creators/4570/sim-na",
            "id": 4570,
            "status": "ACTIVE"
        }
    ],
    "status": {
        "totalRecords": 417,
        "startRecord": 0,
        "sortField": "RELEVANCE",
        "recordsPerPage": 25
    }
}