Nekosia API

How to Use This API

1. Random Cat Girl Image

https://api.nekosia.com/api/v1/images/catgirl/random

Returns a random SFW cat girl image with metadata including artist and source.

2. Get Multiple Images

https://api.nekosia.com/api/v1/images/catgirl/random?count=5

Get up to 5 random cat girl images in a single request.

3. Filter by Tags

https://api.nekosia.com/api/v1/images/catgirl/random?tags=blonde,blue-eyes

Filter images by specific tags like hair color (blonde, brown, black, white), eye color (blue, green, red), or features (glasses, hat, tails).

4. JavaScript — Random Nekosia Display

async function getCatgirlImages(count = 1) {
  const resp = await fetch(
    `https://api.nekosia.com/api/v1/images/catgirl/random?count=${count}`
  );
  const data = await resp.json();
  return data.images || [];
}

async function showCatgirl() {
  const images = await getCatgirlImages(1);
  if (!images.length) return;
  
  const img = images[0];
  const container = document.getElementById('anime-container');
  if (container) {
    container.innerHTML = `
      <img src="${img.url}" alt="Cat girl" style="max-width:400px;border-radius:10px">
      <p>Artist: ${img.artist} &mdash; Tags: ${img.tags.join(', ')}</p>
    `;
  }
}

showCatgirl();

5. Python — Download by Tag

import requests

def get_catgirl_by_tag(tag, count=3):
    resp = requests.get(
        'https://api.nekosia.com/api/v1/images/catgirl/random',
        params={'count': count, 'tags': tag}
    )
    data = resp.json()
    
    for i, img in enumerate(data.get('images', [])):
        img_resp = requests.get(img['url'])
        filename = f'catgirl_{tag}_{i+1}.jpg'
        with open(filename, 'wb') as f:
            f.write(img_resp.content)
        print(f'Saved: {filename} (by {img.get("artist", "Unknown")})')

get_catgirl_by_tag('blonde')