# 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:

| Input | What it is |
|---|---|
| `clientId`, `assignedDomain` | The brand and the site. Required. |
| `targetPageUrl` or `targetPageId` | The page on your site the link points to. |
| `anchorText` | The words that carry the link. |
| `offeringType` | `guest_post` (a new article) or `link_insertion` (a link in an article that is already live). |
| `deliveryMonth` | The month you want it delivered. |
| `ownContent` | `true` when you write the article yourself. |
| `acceptLinkTermMonths` | For 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](/docs/self-serve/find-sites)).

3. `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.

- **You.** Set `ownContent: true` on the item (or later with `line_items_update`). Then no AI topic or article
  starts on that item. Upload the article when it is ready: [Buy a placement with your own
  article](/docs/self-serve/own-article).
- **Linkio's article system.** Leave `ownContent` off. See [Linkio's article system](/docs/self-serve/linkio-article).

## 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.