# Find sites

Search the site inventory, read a site's record and seller, choose a seller policy, and check a site before you buy it.

## Search in the app

1. Open https://www.linkio.com/websites.
2. Type a topic in the search box, for example `marketing`.
3. Use the filters if necessary: DR, Traffic, **Max Cost** and **Seller policy**.

Each row shows the site's numbers, the seller type (owner or reseller) and the guest post price.

## Search with an agent

`website_search` searches the inventory by topic (`topicQuery`), by domain (`domain`) or by filters:
`minDR`, `minTraffic`, `maxPrice`, `hasGuestPost`, `hasLinkInsert`, `ownerAvailable`, `provenSeller`. Sort with
`sortBy` (`relevance`, `dr`, `traffic`, `price_asc`, `price_desc`). `client_excluded_domains_list` shows your
brand's exclusion list: the domains that site searches leave out.

Price: a domain lookup is free. A topic or filter search is free for the first 100 sites of the day, then
0.25c a site.

`ai_find_sites_start` is the automated search. For the target pages you choose, it searches with their
keywords, grades the matches and repeats until it reaches your goal. It runs 5-30 minutes and holds the
`ai_find_sites` estimate first. `ai_find_sites_status` reports progress. Read the exclusion list
(`client_excluded_domains_list`) before you start it.

## What a result tells you

| Field | Meaning |
|---|---|
| DR, traffic | The site's authority and traffic. |
| `guestPostCost` | The price you pay the publisher for a guest post, in dollars. `priceRange` is the spread between its sellers. |
| `history` | The site's record with Linkio: attempts, delivered, failed with the reason. |
| `seller` | Who sells the site: `owner`, `reseller` or `owner_unverified`, and whether that seller is proven. A reseller is never named. |
| `timeLimited` | Set when the site keeps the link live for a set time only, such as 12 months. |

A seller is proven when its latest paid placement on the site cost no more than its price today.

## Choose the seller

Many sites have more than one seller: the owner, and resellers. A seller policy decides which seller a site is
priced and booked with:

| Policy | The seller |
|---|---|
| `linkio_default` | The verified owner, unless a reseller is at least 15% cheaper and proven at that price |
| `owner_only` | Verified owners only |
| `proven_only` | Only proven sellers |
| `cheapest` | The lowest price from any seller in good standing |

Set it for one search (`sellerPolicy` on `website_search`), for one order (`sellerPolicy` on `order_create`) or
for the account (`account_seller_policy_set`). In the app, the **Seller policy** filter on
https://www.linkio.com/websites sets it for the search. The closest one wins. A site added to an order is booked with the
seller and price that a search under the same policy shows. Details:
[API reference, section 10](/docs/api).

## Time-limited sites

Some sites keep a link live for a set time, such as 12 months. When that time ends, the link may come down and
is not replaced. A search leaves these sites out unless you pass `includeTimeLimited: true`. To order one, you
accept the term: see [Order a placement](/docs/self-serve/order).

## Check a site before you buy it

With your agent or the API.

A site from a search comes with its keyword overlap and grade. A site you name yourself has none until it is
analyzed: keyword overlap with your target pages, a grade (`high_quality`, `good_quality`, `marginal_quality` or
`disqualified`) and the best matching target page. Each site takes about 1-3 minutes and is paid.

- Before an order: `bulk_analysis_add_domains`.
- On an order: `line_items_analyze`, or `qualify: true` when you add the site with `line_items_add_to_order`.