Trace Moe API

⭐ Beginner's Pick Anime / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

Trace.moe finds the exact anime scene matching a screenshot or image you upload, returning the anime title, episode number, and timestamp of the matching scene. It uses video fingerprinting to search a database of thousands of anime episodes. Beginners building anime identification tools or Discord bots will find it straightforward since no API key is required.

💡

Beginner Tip

You can search by either uploading an image file or passing an image URL as the url query parameter. For quick tests, try passing a direct image URL to avoid multipart form setup.

Available Data

anime/manga title
episode count
airing status
synopsis
rating score
genre list

Example Response

JSON Response
{
  "id": "Dwu85P9SOIk",
  "urls": {
    "full": "https://images.unsplash.com/photo-...",
    "regular": "https://images.unsplash.com/photo-...?w=1080",
    "thumb": "https://images.unsplash.com/photo-...?w=200"
  },
  "width": 4000,
  "height": 3000,
  "user": {
    "name": "John Doe",
    "username": "johndoe"
  }
}

Field Reference

result Ordered list of scene matches, highest similarity first.
result[].filename Filename of the matched anime video file used for identification.
result[].episode Episode number within the series where the scene was found.
result[].from Start timestamp in seconds of the matching scene.
result[].to End timestamp in seconds of the matching scene.
result[].similarity Confidence score from 0.0 to 1.0; values above 0.9 are reliable matches.

Implementation Example

const url = "https://soruly.github.io/trace.moe-api/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

400 Bad Request No image was provided or the image URL is not publicly accessible.
Ensure the URL points directly to an image file (jpg/png) without redirects, or upload the file as multipart/form-data.
429 Too Many Requests Exceeded the anonymous rate limit (10 searches per 10 seconds).
Obtain a free API token at trace.moe to get a higher quota, or add delays between requests.
503 Service Unavailable The trace.moe search engine is temporarily overloaded.
Retry with exponential backoff; the service typically recovers within seconds.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 43ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS NO
Category Anime
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →