Custom index

Search the pages you choose.

Add a sitemap, a feed or a list of URLs. We read them, re-read them every day, and your agent searches them with the same API: every result with the probability that it’s the right one, plus the answers you ask for, like price or stock.

Create an index Read the docs

POST /v1/indexes$2.00 / 1k URLs a month

idx_8f3k2m9qtrail running shoes under $120

Catalog

active

1,284ready
12pending
3blocked

sitemap.xml · checked 14 min ago
Every URL re-read daily

Ridgeline Trail 4 · trail running shoe
shop.example/p/ridgeline-trail-4
$109InStockin_stock 0.98
0.96
Canyon Grip GTX · waterproof trail shoe
shop.example/p/canyon-grip-gtx
$119InStockin_stock 0.95
0.92
Summit Racer 2 · lightweight trail racer
shop.example/p/summit-racer-2
$124OutOfStockin_stock 0.03
0.41

Sample output

Up and running in minutes

1
Add your pages
Send a list of URLs, a sitemap or an RSS feed, up to 1,000 URLs per request. We read every public page right away.
POST /v1/indexes/{id}/urls
2
It stays fresh on its own
We re-read every URL daily and check sitemaps and feeds every hour, so new pages show up by themselves.
daily · hourly
3
Your agent searches
Add index to your search, from the API or the MCP server. Same modes, same prices.
index: "idx_…"

You pick the pages. We do the rest.

01
Nothing to build
No crawlers, no embeddings, no cron jobs. We read your pages, re-read them daily and pull out price, stock, brand and SKU when the page declares them.
02
Relevance you can trust
Every result carries the probability that it’s the right one. 0.9 means yes, 0.5 means unsure, and we say so. Set a threshold and move on.
03
Answers, not just links
Ask what you need to know, like whether size M is in stock or the price changed, and get the answer on every result, in the same call.

One index, many uses

Pick your sector to see what you add and what your agent gets back.

Answers straight from your catalog

A shopper asks “do you have the Alpine rain jacket in size M?”. Your agent searches your product pages and replies with the link, the price and whether it’s in stock.

What you add

Your product sitemap
Competitor product pages

What your agent gets

The right product, with its link
Whether size M is in stock
Price and availability as data

Sample output

idx_8f3k2m9qAlpine rain jacket in size M

Alpine Rain Jacket · men’s
shop.example/p/alpine-rain-jacket
$189InStocksize_m_in_stock 0.94
0.97
Alpine Rain Jacket · women’s
shop.example/p/alpine-rain-jacket-w
$189InStocksize_m_in_stock 0.08
0.84
Storm Shell 2 · rain jacket
rival.example/storm-shell-2
$159OutOfStocksize_m_in_stock 0.03
0.46

See the request · POST /v1/search

{
  "query": "Alpine rain jacket in size M",
  "index": "idx_8f3k2m9q",
  "mode": "fast",
  "questions": {
    "size_m_in_stock": {
      "type": "boolean",
      "instructions": "Is size M in stock?"
    }
  }
}

Catch it before the press does

Guidance, dividends and material events show up first on investor-relations pages and press releases. Your agent finds them there, company by company, and tells you how much they matter.

What you add

Investor-relations pages
Press-release feeds
Regulator pages

What your agent gets

New or revised guidance announcements
How much each one matters, on your scale
The same query on the news, to see the coverage

Sample output

idx_4b7n1x2cInitech guidance update

Initech raises full-year revenue guidance
ir.initech.example/news/q3-2026-results
new_guidance 0.96impact High
0.95
Initech declares quarterly dividend
ir.initech.example/news/dividend-q3
new_guidance 0.04impact Low
0.28

See the request · POST /v1/search

{
  "query": "Initech guidance update",
  "index": "idx_4b7n1x2c",
  "mode": "normal",
  "questions": {
    "new_guidance": {
      "type": "boolean",
      "instructions": "Does the page announce new or revised guidance?"
    },
    "impact": {
      "type": "score",
      "instructions": "How much does it matter for the company?",
      "criteria": ["None", "Low", "Moderate", "High"]
    }
  }
}

What people say about your brand, and where

Reviews, resellers and forums talk about you every day. Your agent tells you where you’re mentioned, in what tone, and who sells below your minimum price.

What you add

Review pages
Reseller listings
Forum threads

What your agent gets

Where you’re mentioned, and in what tone
Who lists you below your minimum price
The listed price, as data

Sample output

idx_2k9d5r7wAcme heaters reviews and listings

Acme Heat 3000 space heater · $169
deals.example/acme-heat-3000
$169below_min_price 0.97
0.93
Acme Heat 3000 review: loud, but it works
reviews.example/acme-heat-3000
tone negativebelow_min_price 0.02
0.88

See the request · POST /v1/search

{
  "query": "Acme heaters reviews and listings",
  "index": "idx_2k9d5r7w",
  "mode": "fast",
  "tone": true,
  "questions": {
    "below_min_price": {
      "type": "boolean",
      "instructions": "Is the Acme heater listed below the minimum advertised price of 199 USD?"
    }
  }
}

Every new rule, without the hunt

Agencies and official gazettes publish on their own schedule and in their own format. Your agent spots the new rule on your topic and tells you what stage it’s at.

What you add

Official gazettes
Agency news pages
Public consultations

What your agent gets

New or amended rules on your topic
Their stage: consultation, adopted or in force
When each page last changed

Sample output

idx_6p3v8t1mnew rule on battery recycling

Battery regulation: final text adopted
gazette.example/2026/battery-recycling
new_rule 0.95stage adopted
0.94
Public consultation on battery labeling
agency.example/consultations/battery-labels
new_rule 0.61stage consultation
0.58

See the request · POST /v1/search

{
  "query": "new rule on battery recycling",
  "index": "idx_6p3v8t1m",
  "mode": "normal",
  "questions": {
    "new_rule": {
      "type": "boolean",
      "instructions": "Does the page announce a new or amended rule on battery recycling?"
    },
    "stage": {
      "type": "choice",
      "instructions": "What stage is the rule at?",
      "criteria": {
        "consultation": null,
        "adopted": null,
        "in_force": null
      }
    }
  }
}

See what your competitors change

Prices, plans and features change without notice. We re-read your competitors’ pages every day, and your agent separates what matters from the noise.

What you add

Pricing pages
Changelogs
Careers pages

What your agent gets

Whether there’s a new price or plan
How much it matters to you, on your scale
When each page last changed

Sample output

idx_9h2q4z6yGlobex pricing and plans

Globex pricing: new Team plan at $49
globex.example/pricing
price_change 0.93matters A lot
0.96
Globex changelog: dark mode and bug fixes
globex.example/changelog
price_change 0.05matters A little
0.31

See the request · POST /v1/search

{
  "query": "Globex pricing and plans",
  "index": "idx_9h2q4z6y",
  "mode": "normal",
  "questions": {
    "price_change": {
      "type": "boolean",
      "instructions": "Does the page show a price change or a new plan?"
    },
    "matters": {
      "type": "score",
      "instructions": "How much does it matter for a competing product?",
      "criteria": ["Not at all", "A little", "A lot"]
    }
  }
}

Why not a vector database or your site search?

Both are great at what they were made for. A custom index is made for agents that have to act on the answer.

Why not a vector database or your site search?	Vector database	Site search	Custom index
What you get back	How similar the text is, not whether it answers	Keyword matches and your boosts	The probability that the page answers the query
Who reads the pages	You: fetch, chunk and embed	You: push records or set up a crawler	We do, from your URLs, sitemaps and feeds
Staying fresh	You re-embed	You reindex	On its own: every day, sitemaps every hour
Price, stock and other answers	Another step you build	Filters you define up front	On every result, in the same call
Made for	Retrieval inside your app	People typing in a search box	Agents, over the API and MCP

Need millisecond retrieval over millions of records, or a search box for your shoppers? Keep those. A custom index is for when your agent needs a reliable answer from pages you choose.

API

One more parameter on your search

If you already search with typesearch, it’s one more parameter: POST /v1/search with index, in plain JSON. The MCP server’s search_news takes it too, so your agent searches your pages and the news with the same tool.

Read the docs Integrations

# 1. Create an index
curl https://api.typesearch.ai/v1/indexes \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Catalog" }'
# 201 Created · { "id": "idx_8f3k2m9q", "object": "index", … }
 
# 2. Add a sitemap (or up to 1,000 URLs, or a feed)
curl https://api.typesearch.ai/v1/indexes/idx_8f3k2m9q/urls \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sitemap": "https://shop.example/sitemap.xml" }'
# 202 Accepted · read right away, then every day
 
# 3. Search it
curl https://api.typesearch.ai/v1/search \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "trail running shoes under $120", "index": "idx_8f3k2m9q", "mode": "fast" }'

Your pages, in good hands

Only public pages
We read what anyone can open: nothing behind a login, cookies or a paywall. Private addresses and internal networks are rejected.
We respect every site
We follow robots.txt and the same opt-out rules as the news index. If a page doesn’t want to be read, it comes back as blocked.
Yours alone
Your index belongs to your organization. No other customer can search it.
Never used to train models
Not your URLs, not the pages we read for them, not your queries.

Pricing

Pay only for the URLs you keep

$2.00/ 1k URLs a month

An index with 100 URLs costs $0.20 a month; one with 10,000, $20. Billed daily from the same prepaid credit, with re-reading included. Searching it costs the same as any search: $1.00 per 1,000 in ultra, $1.40 in fast, $2.20 in normal and $5.60 in deep.

Create an index Talk to sales

URLs per plan

Pay as you goUp to 100 URLs · 3 indexes
Monthly credit planUp to 10,000 URLs · 50 indexes
EnterpriseUnlimited

More than 100 URLs? They come with the monthly credit plan, from $50 a month.

Searches over your index

ultra$1.00
fast$1.40
normal$2.20
deep$5.60

/ 1k searches

Custom index questions

What can I put in an index?

Any public page: products, investor relations, press releases, official gazettes, reviews, documentation. Add URLs directly (up to 1,000 per request), or give us a sitemap or an RSS or Atom feed and we take the URLs from it.

How fresh is it?

Every URL is re-read once a day. Sitemaps and feeds are checked every hour, and new or updated URLs are read right away. Each URL shows when it was read, when it last changed and when it will be read next.

How much does it cost?

$2.00 per 1,000 URLs a month, billed daily from your prepaid credit: 100 URLs cost $0.20 a month, and 10,000 URLs on the monthly plan cost $20. Re-reading is included, and searching your index costs the same as any search in that mode.

How many URLs can I add?

Up to 100 URLs in 3 indexes pay as you go, and up to 10,000 in 50 indexes with the monthly credit plan. Enterprise has no limit. URLs past your limit come back as over_limit and are not added.

What happens if my credit runs out?

The index is paused: your URLs stay, but they aren’t re-read until you top up. Then it picks up where it left off.

Can my agent use it from the MCP server?

Yes. search_news takes an optional index parameter: pass your idx_… and it searches your index instead of the news, with the same key and prices.

Do you read pages that block crawlers?

No. We honor robots.txt and the same opt-out rules as the news index. A URL we can’t read comes back as blocked, and we try it again a week later.

Can I search my index and the news together?

Each request searches one or the other, and a request with index takes one query. Send the same query twice, with your index and without it, to see your pages next to the press coverage.

Point your agent at your own pages.

Create an index, add a sitemap and run your first search in minutes. Up to 100 URLs pay as you go, 10,000 on the monthly plan.

Create an index Talk to sales

Search the pages you choose.

Up and running in minutes

Add your pages

It stays fresh on its own

Your agent searches

You pick the pages. We do the rest.

Nothing to build

Relevance you can trust

Answers, not just links

One index, many uses

Answers straight from your catalog

Catch it before the press does

What people say about your brand, and where

Every new rule, without the hunt

See what your competitors change

Why not a vector database or your site search?

One more parameter on your search

Your pages, in good hands

Only public pages

We respect every site

Yours alone

Never used to train models

Pay only for the URLs you keep

Custom index questions

Point your agent at your own pages.