Developer API

Tackle.net API

Search the lure catalog, check whether a shop can be imported, or submit a maker's shop in one streaming POST.

Try it

Test item search

Search query

LimitCategory

Request URL

/api/items-search?q=swimbait&limit=6

Response

Ready

Click "Run request" to see a live JSON response.

GET/api/items-search

q

Required search text. search also works as an alias.

limit

Optional result count. Defaults to 12, maximum 50.

Response

JSON with items, count, and basic search metadata. Each item can include maker details, price, slug, category, and up to three media images.

See advanced options

offset

Optional zero-based offset for pagination.

category

Optional exact category slug, like swimbaits.

CORS

GET and OPTIONS responses include Access-Control-Allow-Origin: *.

Category slugs

{
  "swimbaits": "Swimbaits",
  "swimbaits-soft": "Soft Swimbaits",
  "topwater-baits": "Topwater Baits",
  "glide-baits": "Glide Baits",
  "crankbaits": "Crankbaits",
  "jerkbaits": "Jerkbaits",
  "spinnerbaits": "Spinnerbaits",
  "buzzbaits": "Buzzbaits",
  "soft-plastic-baits": "Soft Plastics",
  "soft-plastic-worms": "Soft Plastic Worms",
  "soft-plastic-creatures": "Creature Baits",
  "soft-plastic-craws": "Soft Plastic Craws",
  "soft-plastic-tubes": "Soft Plastic Tubes",
  "soft-plastic-jerkbaits": "Soft Jerkbaits",
  "soft-plastic-grubs": "Grubs & Minnows",
  "frogs": "Frogs",
  "jigs": "Jigs",
  "umbrella-rigs": "Umbrella Rigs",
  "pike-musky-lures": "Pike & Musky",
  "accessories": "Accessories",
  "bait-accessories": "Lure Accessories",
  "bait-making-materials": "Bait Making Materials",
  "terminal-tackle": "Terminal Tackle",
  "line-and-leaders": "Line & Leaders",
  "tackle-storage": "Tackle Storage",
  "tools-nets-and-measuring": "Tools, Nets & Measuring",
  "prepared-baits": "Prepared Baits & Attractants",
  "traps-and-cages": "Traps & Cages",
  "live-bait-equipment": "Live Bait Equipment",
  "sabiki-rigs": "Sabiki Rigs",
  "rods-and-reels": "Rods & Reels",
  "apparel-and-gear": "Apparel& Gear",
  "brand-merch": "Brand Merch",
  "gift-cards": "Gift Cards",
  "guide-trips-and-lodges": "Guide Trips & Lodges",
  "shooting-archery-storage": "Shooting & Archery Storage",
  "collectibles-and-decor": "Collectibles & Decor",
  "other": "Other",
  "bass": "Bass Fishing",
  "saltwater-inshore": "Saltwater Inshore",
  "fly-fishing": "Fly Fishing",
  "trout": "Trout Fishing",
  "panfish": "Panfish & Crappie",
  "carp": "Carp Fishing",
  "ice-fishing": "Ice Fishing",
  "saltwater-offshore": "Saltwater Offshore",
  "catfish": "Catfish",
  "walleye": "Walleye",
  "salmon-steelhead": "Salmon & Steelhead",
  "pike-musky": "Pike & Musky",
  "inshore-poppers": "Inshore Poppers",
  "inshore-plugs": "Inshore Plugs",
  "inshore-jigs": "Inshore Jigs",
  "inshore-swimbaits": "Inshore Swimbaits",
  "inshore-soft-baits": "Inshore Soft Baits",
  "inshore-accessories": "Inshore Accessories",
  "inshore-lures": "Inshore Lures",
  "fly-dry-flies": "Dry Flies",
  "fly-nymphs": "Nymphs",
  "fly-streamers": "Streamers",
  "fly-wet-flies": "Wet Flies",
  "fly-saltwater-flies": "Saltwater Flies",
  "fly-accessories": "Fly Accessories",
  "trout-spinners": "Trout Spinners",
  "trout-spoons": "Trout Spoons",
  "trout-soft-plastics": "Trout Soft Plastics",
  "trout-plugs": "Trout Plugs",
  "trout-flies": "Trout Flies",
  "trout-accessories": "Trout Accessories",
  "panfish-jigs": "Panfish Jigs",
  "panfish-soft-plastics": "Panfish Soft Plastics",
  "panfish-spinners": "Panfish Spinners",
  "panfish-tubes": "Panfish Tubes",
  "panfish-floats-accessories": "Floats & Accessories",
  "carp-boilies": "Carp Boilies",
  "carp-rigs": "Carp Rigs",
  "carp-feeders": "Carp Feeders",
  "carp-bait-and-attractants": "Carp Bait & Attractants",
  "carp-accessories": "Carp Accessories",
  "ice-jigs": "Ice Jigs",
  "ice-spoons": "Ice Spoons",
  "ice-soft-baits": "Ice Soft Baits",
  "ice-tip-ups": "Tip-Ups & Set Lines",
  "ice-rods-and-reels": "Ice Rods & Reels",
  "ice-accessories": "Ice Accessories",
  "offshore-trolling": "Offshore Trolling",
  "offshore-jigs": "Offshore Jigs",
  "offshore-poppers": "Offshore Poppers",
  "offshore-stickbaits": "Offshore Stickbaits",
  "offshore-soft-baits": "Offshore Soft Baits",
  "offshore-accessories": "Offshore Accessories",
  "catfish-bait": "Catfish Bait",
  "catfish-rigs": "Catfish Rigs",
  "catfish-jugs": "Catfish Jugs",
  "catfish-accessories": "Catfish Accessories",
  "walleye-jigs": "Walleye Jigs",
  "walleye-crankbaits": "Walleye Crankbaits",
  "walleye-jerkbaits": "Walleye Jerkbaits",
  "walleye-spinner-rigs": "Walleye Spinner Rigs",
  "walleye-soft-plastics": "Walleye Soft Plastics",
  "walleye-accessories": "Walleye Accessories",
  "salmon-spoons": "Salmon Spoons",
  "salmon-plugs": "Salmon Plugs",
  "salmon-spinners": "Salmon Spinners",
  "salmon-jigs": "Salmon Jigs",
  "salmon-flies": "Salmon Flies",
  "salmon-beads": "Salmon Beads",
  "pike-musky-bucktails": "Bucktails",
  "pike-musky-glides": "Glide Baits",
  "pike-musky-jerkbaits": "Pike & Musky Jerkbaits",
  "pike-musky-topwater": "Pike & Musky Topwater",
  "pike-musky-soft-plastics": "Pike & Musky Soft Plastics"
}

GET/api/stats

Live catalog counts for import verification. This endpoint bypasses the cached homepage counter and returns current bait, maker, video, and comparison totals.

response

Returns baits, makers, videos, comparisons, and updated_at.

CORS

GET and OPTIONS responses include Access-Control-Allow-Origin: *.

GET/api/health

Live operational health for importer diagnostics, including active submit jobs and in-process import duration histograms.

POST/api/suggest-shop

Queue a shop URL for admin review without platform detection, AI classification, or import work.

url

Required shop URL. Bare domains work.

note

Optional short note for admins.

Try it

Check shop support

Runs the fast pre-flight check without importing products.

Shop URL

Request URL

/api/check-shop?url=orvis.com

Response

Ready

Click "Run check" to see a live JSON response.

Try it

Test shop import

Streams Server-Sent Events. Each event is one line of JSON.

Shop URL

updateMakerRe-run AI to refresh the maker name, logo, and bio.updateProductsRe-enrich items already in the catalog (slower).

Request

POST /api/submit-shop
Content-Type: application/json

{
  "url": "yourshop.com"
}

cURL

curl -N -X POST 'https://tackle.net/api/submit-shop' \
  -H 'Content-Type: application/json' \
  -d '{"url":"yourshop.com"}'

Stream 0 events

Ready

Click “Run request” to stream events.

GET/api/check-shop

Fast pre-flight check. Pass url to get platform support, a simple maker/retailer/apparel classification, feed counts, and sample product names without importing anything.

See advanced options

url

Required shop URL. Bare domains work.

response

Returns supported, platform, classification, confidence, feed, topProducts, and signals.

POST/api/submit-shoptext/event-stream

Detect a shop's commerce platform, classify it as a fishing tackle maker, then ingest the catalog. Each new product is enriched with category and applicable AI metadata like dimensions, season, pros/cons, target species, and techniques. General gear keeps species and technique fields empty unless the listing is clearly species-specific. Large feeds are processed in resumable batches.

url

Required shop URL. Bare domains like yourshop.com work.

stream

The response is Server-Sent Events. Read until done or error.

Response stream

Server-Sent Events. Each line is data: {...} with a JSON object. The most important events are status, classification, progress, item, done, and error. The classification event includes detected water type and dominant hub when available, and item events include the final category slug saved for each product.

See advanced options

updateMaker

Optional boolean. Re-runs AI on the maker name, logo, and bio.

updateProducts

Optional boolean. Re-enriches items already in the catalog.

resumeToken

Use the token from a capped done event to continue a large feed.

offset

Optional zero-based feed offset. resumeToken takes priority.

limits

Anon users get 30 submissions per hour and one in-flight import. Signed-in users can run five.

Idempotency-Key

Optional header. Reusing a recent key blocks duplicate submit jobs.

Event types

statusHuman-readable progress string.

authAuthentication state and whether force=true is honored for this request.

jobImport job id and DELETE cancel URL.

platformDetected commerce platform (Shopify, BigCommerce, WooCommerce, Wix, GoDaddy, Squarespace, Square Online, Big Cartel, Magento, Salesforce Commerce Cloud, Shoplazza, Kajabi, custom headless commerce, or static product catalog).

platform_hintsPlatform detection signals, such as matched HTML markers or the successful probe.

shopShop identity: name, origin, logoUrl, heroUrl, description.

feedTotal products discovered in the feed.

classificationAI verdict: approved, reason, confidence (0-1), topProducts, waterType, dominantHub, and forced (true when force=true is honored).

makerMaker upserted in the database (id, slug, created, refreshed).

progressPer-product phase with index, total, and item_url.

itemPer-product result: added, updated, duplicate, skipped, error, or capped. Added/updated items include the final category slug.

doneFinal summary: imported, updated, skipped, duplicates, errors, deterministicSaved, capped, total, nextOffset, and resumeToken.

errorFatal error with message, code, hint, and optional compatibility flags.

PATCH/api/makers/{slug}

Direct maker metadata updates for admins and claimed maker owners. Supports name, bio, logo_url, hero_url, hubs, and tags without re-running AI enrichment.