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",
  "frogs": "Frogs",
  "jigs": "Jigs",
  "umbrella-rigs": "Umbrella Rigs",
  "pike-musky-lures": "Pike & Musky",
  "accessories": "Accessories",
  "bait-accessories": "Lure Accessories",
  "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",
  "rods-and-reels": "Rods & Reels",
  "apparel-and-gear": "Apparel& Gear",
  "brand-merch": "Brand Merch",
  "gift-cards": "Gift Cards",
  "other": "Other",
  "bass": "Bass Fishing",
  "saltwater-inshore": "Saltwater Inshore",
  "fly-fishing": "Fly Fishing",
  "trout": "Trout Fishing",
  "panfish": "Panfish & Crappie",
  "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",
  "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"
}

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. Up to 500 items per request.

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.

Event types

statusHuman-readable progress string.

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

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

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, error, or capped. Added/updated items include the final category slug.

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

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