Documentation

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

FieldMeaning
DR, trafficThe site's authority and traffic.
guestPostCostThe price you pay the publisher for a guest post, in dollars. priceRange is the spread between its sellers.
historyThe site's record with Linkio: attempts, delivered, failed with the reason.
sellerWho sells the site: owner, reseller or owner_unverified, and whether that seller is proven. A reseller is never named.
timeLimitedSet 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:

PolicyThe seller
linkio_defaultThe verified owner, unless a reseller is at least 15% cheaper and proven at that price
owner_onlyVerified owners only
proven_onlyOnly proven sellers
cheapestThe 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.

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.

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.

This page as markdown: /docs/self-serve/find-sites.md. All pages for agents: /llms.txt.