Lookup API - Rift Database

This API allows you to lookup objects in our database easily by Name or ID. Just follow the examples below to access the API. We have various parameters to let you pick different object types and even the returned encoding. A typical response will include the ID, Name, URL, and Icon URLs for that object.

API parameters available:

s - This param is used to set the search string for doing lookups by Name. This should always have a value if searching by Name. The results will mimic our general site search for each object however it will only return up to a maximum of 10 objects.

Sample URL:

http://rift.yg.com/api/lookup?s=Vanguard's%20Grasp

i - This is the ID param and is used for looking up objects by ID. This should always have a value when doing lookups by ID.

Sample URL:

http://rift.yg.com/api/lookup?i=80D6D5E506018999AB8F0668C801

t - Allows you to set the encoding type.

Encoding types:
- json (default)
- xml

Sample URL (json):

http://rift.yg.com/api/lookup?s=Vanguard's%20Grasp&t=json

Sample Response:

{"objects":[{"id":"8F86C1F80301010101","name":"Vanguard's Grasp","url":"http:\/\/rift.yg.com.yg.com\/item\/vanguards-grasp?id=8F86C1F80301010101","icon":{"small":"http:\/\/http://static.ygcdn.com/rift.yg.com\/rift\/img\/game\/icons\/small\/trinket24.jpg","medium":"http:\/\/http://static.ygcdn.com/rift.yg.com\/rift\/img\/game\/icons\/medium\/trinket24.jpg","large":"http:\/\/http://static.ygcdn.com/rift.yg.com\/rift\/img\/game\/icons\/large\/trinket24.jpg"}}]}

Sample URL (xml):

http://rift.yg.com/api/lookup?s=Vanguard's%20Grasp&t=xml

Sample Response:

<?xml version="1.0" encoding="utf-8" ?>

<yg_xml>

  <object>

    <id>8F86C1F80301010101</id>

    <name>Vanguard's Grasp</name>

    <url>http://rift.yg.com.yg.com/item/vanguards-grasp?id=8F86C1F80301010101</url>

    <icons>

     <small>http://static.ygcdn.com/rift/img/game/icons/small/trinket24.jpg</small>

     <medium>http://static.ygcdn.com/rift/img/game/icons/medium/trinket24.jpg</medium>

     <large>http://static.ygcdn.com/rift/img/game/icons/large/trinket24.jpg</large>

    </icons>

  </object>

</yg_xml>

o - Allows you to set the object type.

Object types:
- item (default)
- trait
- ability
- soul
- npc
- quest
- recipe
- artifact
- achievement

Sample URL (item):

http://rift.yg.com/api/lookup?s=Vanguard's%20Grasp&o=item

Note: If parameter t or o is not set in the URL, the API will use their default values.

Sample URLs:

Item:

http://rift.yg.com/api/lookup?s=Epic%20Shard&t=item

Item (Same as above but using the defaults):

http://rift.yg.com/api/lookup?s=Epic%20Shard

Trait:

http://rift.yg.com/api/lookup?s=Bloom&o=trait&t=json

Ability:

http://rift.yg.com/api/lookup?s=Grim%20Silence&o=ability

Soul:

http://rift.yg.com/api/lookup?s=Void%20Knight&o=soul

NPC:

http://rift.yg.com/api/lookup?s=Defiant%20Centurion&o=npc

Quest:

http://rift.yg.com/api/lookup?s=A%20Ceremony%20in%20Sanctum&o=quest

Recipe:

http://rift.yg.com/api/lookup?s=Band%20of%20Crystallized%20Mana&o=recipe

Artifact:

http://rift.yg.com/api/lookup?s=Endless%20Necromancer%20Skulls&o=artifact

Achievement:

http://rift.yg.com/api/lookup?s=Colossal%20Victory&o=achievement

Lookup API - Rift Database - rift.yg.com

Rift Lookup API

API parameters available:

Sample URLs: