Documentation

Order a placement

Open an order, add sites with a target page and anchor text, say who writes the article, and accept a time-limited link.

Order in the app

  1. On https://www.linkio.com/websites, tick the box on the row of each site you want.
  2. Select New Order. The Create Quick Order dialog opens.
  3. Select your brand and the Delivery Month.
  4. Type the Target URL (your page) and the Anchor Text (the words that carry the link).
  5. Select Create & Review Order to open the order, or Create & Continue Browsing to add more sites first.

Order with an agent

  1. order_create opens an empty order for a brand. Optional: sellerPolicy for this order, deliveryMonth.
  2. line_items_add_to_order adds the sites. Each item takes:
InputWhat it is
clientId, assignedDomainThe brand and the site. Required.
targetPageUrl or targetPageIdThe page on your site the link points to.
anchorTextThe words that carry the link.
offeringTypeguest_post (a new article) or link_insertion (a link in an article that is already live).
deliveryMonthThe month you want it delivered.
ownContenttrue when you write the article yourself.
acceptLinkTermMonthsFor a time-limited site: the term you accept (see below).

The seller and the price are looked up for you, under the order's seller policy. Prices are in cents. qualify: true also starts the site check on the new items (a paid check, see Find sites).

  1. line_items_list and order_get show the order. line_items_update changes an item later: its target page, anchor text, delivery month, own-content choice, or its inclusion (included, excluded, saved_for_later).

Anchor text

You can type the anchor text yourself. Or an agent asks for suggestions with article_gen_anchor_suggestions, shows you each one with its type and reason, and applies the ones you approve with article_gen_anchor_apply. Text you write that has no matching suggestion is set with article_gen_set_anchor_text.

Who writes the article

With your agent or the 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. Such a site needs your acceptance of the term on the item: acceptLinkTermMonths with the number of months from the search result (timeLimited.months). That acceptance is recorded on the item.

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