Convertlyft

How many domains and pages link to this site, snapshot by snapshot, and the newest link-gap read as the SEO room shows it: domains linking to the rivals in use (linkGapRivals) but not here. Sites scored over 30 for spam, and sites with neither a spam score nor a rank, are hidden and counted (linkGapsHidden). Served from stored pulls.

Decide the searches listed under a stored SEO content brief’s "Keywords to add" — add, skip, or clear, several at once (the room’s "Add all"). Name the brief by its own search. Idempotent.

Say the page a content brief asked for is live, and where: the address on this site’s own domain (http(s), www folded; a subdomain, port, user name or password is refused; default: the brief’s page). It publishes the brief’s draft exactly as cvl_seo_draft_publish does (sending the brief to Drafts first when it has no draft yet; a brief that cannot become a draft is refused with its reason). The next crawl reads the page back: each checklist item it sees is ticked, and the brief is Confirmed live once the page has the draft’s title and H1. cvl_seo_brief then says whether it Worked: Google views (100+ in either window), average position (20+ views a side and a move of 3+ places) and clicks (10+ in both windows), the 28 days after Confirmed live against the 28 before, before and after, never a cause. Saying it again with a new address starts the read-back over. Free; nothing is bought.

Check where this site ranks in the top 10 right now for one tracked search (keyword), or for every search a market tracks. Free, once a day per search: a search already checked today is not checked again and the answer says so. It starts at once and does not wait; the positions land on cvl_seo_rank within minutes. Only searches the market tracks can be checked (cvl_seo_track_keywords adds one). Omit market for the primary market.

The searches one competitor ranks for that the site does not, best competitor positions first, with monthly volume and the competitor’s ranking page. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Any site’s organic footprint in one country: how many searches it ranks for, how many of those in the top 3, and the provider’s estimate of its monthly search traffic. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Draft a page for one search with Convertlyft’s own writer: the same path as Generate brief then Send to Drafts in the SEO room. It reads the top results, makes the SEO content brief (one of the month’s, counted once it is Ready; a rebuild of one already counted this month is free) and writes the page from your site’s own words; a claim your site never makes becomes a [Fill in: …] gap for you. It does not wait: it answers at once with brief_id, status and poll_after_s; follow it with cvl_seo_draft_status. A brief made in the last 7 days is reused unless force is true; when it is Ready this saves the draft and answers it straight away (draft_not_saved says why when it could not be saved). page_url names the page on your own site it is for (omit for a new page). dry_run: true buys nothing and answers whether a brief would be reused, the SEO content briefs left this month, and what is missing for a good draft (site context, crawl text, site type).

Say a page draft is live: the SEO room’s Mark published. Name it by draft_id (from cvl_seo_drafts or cvl_seo_draft); url is where it went live, on this site’s own domain (omit to keep the address it has, or its page’s). The draft leaves the Drafts count. A draft for a page that already exists closes its SEO to-do and its brief now; a draft for a new page closes them once a crawl finds the page live with the draft’s title and H1 (a finished crawl also publishes such a draft by itself, published_via crawl). Idempotent: the same call again changes nothing (changed: false). A draft this site does not hold is refused with code not_found.

Where the automatic SEO chain stands for this site: crawl, keywords, competitors, SEO to-dos (the opportunities step) and briefs, each done / running / waiting for the daily limit / failed with its reason, plus counts, and a search_console step (done, waiting, or not-connected). briefs is running while any brief is still being made. run_id is the crawl run the chain worked from — the run_id cvl_site_pages and cvl_page_content name. Read from stored rows.

Say a Site audit issue is not a problem on this site (a redirect you put there, a page kept out of Google on purpose): it stops counting and is listed under Not a problem. With page, on that one page only: the issue still counts on its other pages, so a deliberate noindex on /demo never hides an accidental one on the homepage. not_a_problem: false counts it again. A preview unless dry_run: false: show the owner, apply on their yes. Idempotent.

Renamed cvl_seo_issue_not_a_problem, which does the same; this name keeps working until 2026-11-18. Say a Site audit issue is deliberate on this site (a redirect you put there, a page kept out of Google on purpose): it stops counting and is listed as on purpose. on_purpose: false counts it again. A preview unless dry_run: false. Idempotent.

Searches around one seed: searches that contain the seed (mode suggestions, the default: stays on the seed), what Google lists beside it (related), or the provider’s ideas in the same topic (ideas: wider, and often off-topic for a short seed) — each with monthly volume, difficulty, cost per click and intent as the provider estimates them. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

For searches you name: monthly volume, difficulty, intent and the last 12 months of volume, as the provider estimates them. Every search named gets a row; one the provider holds nothing for has null figures and a reason. A list longer than `limit` is answered a page at a time: `remaining` counts the rest and `next` asks for them. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Referring domains that link to one or more of the named competitors and not to the site, with which competitors each links to, its spam score and rank. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Make the SEO content brief for one search: it reads the live top results, crawls the top pages and writes suggestions. It uses one of the month’s SEO content briefs (refilled on the 1st), inside this site’s daily limit, with no per-call confirmation. A brief made in the last 7 days is returned as it is unless force is true. cvl_seo_brief reads it. dry_run: true gives, without making it, how much of today’s limit is used (rounded) and whether it fits (fits_today); nothing is charged per call. page_url (the Overview’s “Refresh this page” move): the brief is locked to that page of this site and every rebuild keeps it; with no keyword it plans for the page’s own title as the last crawl read it. Give keyword, page_url or both; the answer’s keyword is the search the brief is for. A search whose brief is already locked to another page is refused.

Say which page of the site targets a search. Answers the page it had before.

The ranked to-do list: searches your competitors win and you do not, related searches around your money keywords, and Search Console near-misses (position 8–30, ≥10 impressions in 28 days) — each mapped to a page (page_url, null for a new page) with one action (improve / create / track), the reason, the evidence date and its brief. priority is the stored score; dots is that score as 1–5 relative to the top row on this page, for display only. briefStatus is the brief for that search: null (none), queued, crawling, ready or failed; briefOpened says whether someone has opened it.

Set aside a content brief idea from cvl_seo_opportunities (an improve or create row). mark not_for_us: never suggested again — off the Content briefs list, never briefed by the chain, listed under Not for us. mark later: out of the list until `when` (tomorrow, week, month, or a day YYYY-MM-DD from tomorrow to a year ahead; UTC), and back early when its data changes (a newer crawl that reads its own page, or its position moving 3+ places or into another band: 1–3, 4–10, 11–50, 51–100, out of the top 100). mark show_again: undoes either. A row that is done or tracked is not changed. Free; idempotent.

Act on an SEO to-do from cvl_seo_opportunities by tracking its search. Idempotent.

The searches any site ranks for in the top 30 in one country, as the provider’s index holds them, biggest search first: each with the position, the ranking page, and monthly volume, difficulty and intent as the provider estimates them. For this site’s own searches as Google reports them, cvl_seo_search_console (free) is the measured read; this one also works for a competitor or a site with no Search Console. Empty rows with a reason when the provider holds nothing for the domain. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

The sites that link to any site, from the provider’s link index, best-ranked first: each with the day it was first seen (and lost, if it was), its rank and spam score (0–100, the provider’s estimates), and of the links the provider describes how many are nofollow and how many are not (ugc and sponsored marks are counted apart, never as followed for sure). `since` keeps only the sites first seen on or after a day: what a jump in linking sites between two backlink snapshots is made of, and whether it is spam. A page at a time: next_cursor asks for the next one. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Run the SEO chain again from the newest crawl (or from one step): keywords, competitors, SEO to-dos and SEO content briefs. Search data is included in the plan, inside this site’s daily limit, with no per-call confirmation; each new brief uses one of the month’s SEO content briefs. It starts at once; cvl_seo_flow follows it. A step that meets the limit waits for tomorrow. cvl_usage shows what was used. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether it fits (fits_today); nothing is charged per call.

The live first page of Google results for one search in one country: position, address, domain and title of each organic result, the "People also ask" questions, and every other block the page held — ads, AI overview, map pack, video and the rest — as features, typed by the provider. Ads and other blocks take places, so the first page can hold fewer than 10 organic results; organic_note says so. Research is included in the plan, inside this site’s daily limit for paid search data, with no per-call confirmation. The answer is stored, so asking the same question again is instant (refresh: true buys again). cvl_usage shows what was used. Included in the plan, inside this site’s daily limit. dry_run: true gives, without buying, how much of today’s limit is used (rounded) and whether this call fits (fits_today).

Pin a competitor (always used), hide one (state hidden, or its older name dismissed: hidden 180 days, or until it shares twice as many money keywords), or clear the choice. An authority site cannot be pinned. Idempotent. dry_run: true changes nothing and answers the competitors allowance a pin would use (before, after, fits) and why it would be refused, if it would.

Mark a search as a money keyword (counts for competitors and SEO to-dos) or not. The same call with the other value undoes it.

Submit one sitemap to Google Search Console for this site. A preview by default: without confirm: true it answers what would be sent and whether the connection may send it, and sends nothing — show that to the owner and submit only once they agree. With confirm: true it submits, answers the sitemap’s state and a next hint to re-check it later with cvl_seo_sitemaps; Google reads a submitted sitemap on its own schedule. Submitting does not put pages on Google by itself. feedpath defaults to /sitemap.xml at the site. needs_write_access means the connection was granted read-only access: the owner grants it once from the Indexing tab in the SEO room.