Fat Fingers APIfatfingers.com ↗
Find misspelled eBay listings across 16 regional domains. The Fat Fingers API returns typo variations and direct search URLs to surface low-competition deals.
What is the Fat Fingers API?
The Fat Fingers API exposes a single endpoint, find_typo_bargains, that accepts a product name and returns an array of common seller misspellings alongside direct eBay search URLs across up to 16 regional domains. Each result object includes the site key, domain, search_url, typo_query, and a misspellings array, giving you everything needed to query under-indexed eBay listings programmatically.
curl -X GET 'https://api.parse.bot/scraper/170d8bd8-13da-4742-9406-09b6841744f3/find_typo_bargains?ebay_site=us&product_name=iphone' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fatfingers-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FatFingers eBay Typo Finder — find misspelling bargains."""
from parse_apis.fatfingers_com_api import FatFingers, EbaySite, InputFormatInvalid
client = FatFingers()
# Find typo bargains for a product across all eBay domains.
report = client.typo_reports.find(product_name="nintendo")
print(f"Product: {report.product_name} — {report.total_sites} site(s) returned results")
for result in report.results:
print(f" [{result.site}] {result.domain}")
print(f" Typo query: {result.typo_query}")
print(f" Misspellings: {', '.join(result.misspellings)}")
print(f" Search URL: {result.search_url}")
# Narrow to a single eBay region for faster results.
try:
uk_report = client.typo_reports.find(product_name="samsung", ebay_site=EbaySite.UK)
if uk_report.results:
first = uk_report.results[0]
print(f"\nUK typo search for samsung: {first.typo_query}")
except InputFormatInvalid:
print("Invalid site or product name format")
print("\nexercised: typo_reports.find (all sites / single site)")
Given a product name, generates common misspellings and typos that sellers make on eBay listings, and returns search URLs for those misspellings across one or all supported eBay regional domains. Each domain may produce different typo variations. The endpoint makes one request per queried domain (up to 16 if no site filter is specified), so specifying ebay_site reduces latency. Results include the full typo search query and the individual misspellings extracted from it.
| Param | Type | Description |
|---|---|---|
| ebay_site | string | eBay regional site to query. When omitted, returns results for all 16 supported eBay domains. |
| product_namerequired | string | The product name to find misspellings for (e.g. 'iphone', 'nintendo', 'samsung'). Max 50 characters. |
{
"type": "object",
"fields": {
"results": "Array of typo search results per eBay domain, each containing site key, domain, search_url, typo_query, and misspellings array",
"total_sites": "Number of eBay domains that returned results",
"product_name": "The queried product name"
},
"sample": {
"data": {
"results": [
{
"site": "us",
"domain": "www.ebay.com",
"search_url": "https://www.ebay.com/sch/i.html?_nkw=(i+phone,+phone)+-iphone&mkcid=1&mkrid=711-53200-19255-0&siteid=0&campid=5338784378&customid=&toolid=10001&mkevt=1",
"typo_query": "(i phone, phone) -iphone",
"misspellings": [
"i phone",
"phone"
]
}
],
"total_sites": 1,
"product_name": "iphone"
},
"status": "success"
}
}About the Fat Fingers API
What the API Returns
The find_typo_bargains endpoint takes a product_name string (up to 50 characters) and generates common typographical variations that sellers make when listing items on eBay. For each eBay regional domain, the response includes a search_url you can open directly, a typo_query string, and a misspellings array enumerating each individual variant. The top-level response also contains total_sites, indicating how many domains returned results, and echoes back the original product_name.
Regional Coverage
The optional ebay_site parameter lets you target a specific eBay domain. Omit it and the API queries all 16 supported regional eBay domains in a single call, returning one result block per domain. Different domains can produce different typo variations, so the same product name may yield distinct misspellings arrays depending on the site. The results array groups everything by domain, so you can iterate over regions or filter down to the ones relevant to your market.
Practical Behavior
Each entry in results contains a ready-to-use search_url pointing to an eBay search filtered to the generated typos. This means you can drive a browser, monitoring script, or deal-alert pipeline directly from the API response without any additional URL construction. The endpoint is stateless — every call recomputes typo variants fresh for the given product_name.
The Fat Fingers API is a managed, monitored endpoint for fatfingers.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fatfingers.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fatfingers.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a deal-alert bot that monitors misspelled eBay listings for a watchlist of product names across multiple regional domains.
- Aggregate
search_urlresults from all 16 eBay domains into a dashboard for cross-regional bargain hunting. - Filter the
misspellingsarray to feed into a keyword research tool tracking how often typo listings appear. - Power a browser extension that surfaces Fat Fingers typo links alongside standard eBay search results.
- Automate periodic checks of
typo_queryvariations for collectibles or rare electronics with historically low listing counts. - Generate a report comparing typo-listing density across eBay regional sites for a given product category.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Fat Fingers have an official developer API?+
What does the `find_typo_bargains` endpoint return for each eBay domain?+
site key, the domain string, a search_url linking directly to the eBay typo search, a typo_query string representing the combined query, and a misspellings array listing each individual variant generated for that domain.Does the API return actual eBay listing data such as prices, item titles, or bid counts?+
Are all 16 eBay regional domains guaranteed to return results for every product name?+
total_sites field in the response indicates how many domains actually returned results for a given query. Domains that produce no typo variants for a product name will not appear in the results array. The ebay_site parameter lets you narrow the query to a single domain if you only need one region.