NPCs

Hunters and townsfolk: quests, gifts, drops, and placements.

List NPCs

GET /v1/bloodborne/npcs?page=1&page_size=1

Supports pagination. Summaries include optional role and location_slug.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/npcs?page=1&page_size=1"

Example response

200 OK

{
  "data": [
    {
      "slug": "eileen-the-crow",
      "name": "Eileen the Crow",
      "role": null,
      "location_slug": "central-yharnam"
    }
  ],
  "meta": { "page": 1, "page_size": 1, "total": 26 }
}

Get NPC by slug

GET /v1/bloodborne/npcs/eileen-the-crow

Detail adds quest_notes, gifts, drops, placements, and time_of_day.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/npcs/eileen-the-crow"

Example response

200 OK

{
  "data": {
    "slug": "eileen-the-crow",
    "name": "Eileen the Crow",
    "location_slug": "central-yharnam",
    "campaign": "main_story",
    "is_dlc": false,
    "time_of_day": ["day", "evening", "blood_moon"],
    "gifts": [
      { "name": "Bold Hunter's Mark", "kind": "item", "item_slug": "bold-hunters-mark" },
      { "name": "Shake Off Cape", "kind": "gesture", "gesture_slug": "shake-off-cape" }
    ],
    "drops": [
      { "name": "Crow Hunter Badge", "quantity": null, "drop_rate": null, "condition": "corruption" }
    ],
    "placements": [
      { "location_slug": "central-yharnam", "sub_area": "Dry Dock - Rafters" },
      { "location_slug": "cathedral-ward", "sub_area": "Oedon Chapel" }
    ]
  }
}

Not found (404)

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/npcs/unknown-npc-xyz"

{notFoundExample}