{ "openapi": "3.0.1", "info": { "title": "Link Building Prospects & Guest Post Finder (Google, AI)", "description": "First 25 prospects free. Link building prospects from Google Search: guest-post, resource and listicle pages with contact route, fit score and AI opener. Pay per qualified prospect: junk and repeat domains never charged. Free demo on any plan; live search runs on your own Apify account.", "version": "0.3", "x-build-id": "CdEzTsQt7gdwqKNvn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rich_minds~link-building-prospects-ai/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rich_minds-link-building-prospects-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rich_minds~link-building-prospects-ai/runs": { "post": { "operationId": "runs-sync-rich_minds-link-building-prospects-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rich_minds~link-building-prospects-ai/run-sync": { "post": { "operationId": "run-sync-rich_minds-link-building-prospects-ai", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sourceMode" ], "properties": { "sourceMode": { "title": "Where do the prospects come from?", "enum": [ "actor", "dataset", "list" ], "type": "string", "description": "actor — search Google live: the footprint queries built from your keywords run with apify/google-search-scraper on your Apify account ($0.0045 per Google page + $0.001 per run, billed by that Actor and capped by Max Google search spend); it needs an Apify plan that can run Store Actors — if yours cannot, the run stops at once and nothing is charged. dataset — process an existing Google Search Results Scraper dataset (any plan, no search cost). list — paste Google results or plain URLs, e.g. an Ahrefs / Semrush export (any plan). The form starts on the free demo: 8 sample Google results. An API call that names nothing to search ({}) runs the same free demo — nothing is charged and no search is started.", "default": "actor" }, "keywords": { "title": "Keywords", "type": "array", "description": "1–10 topics your target page is about. For each one the Actor builds the footprint searches for the opportunity types you pick (e.g. \"remote work\" \"write for us\", \"remote work\" intitle:resources, best remote work tools). 4 keywords × the 3 default types = 24 Google searches ≈ 240 results ≈ $0.11 on your account. Leave empty and fill only Page you want links to: 3–5 keywords (and the pitch, when empty) are read from that page's title and headings — logged, and anything you type wins.", "items": { "type": "string" } }, "targetUrl": { "title": "Page you want links to", "type": "string", "description": "The article, tool or page you are building links for. The fit score and the outreach opener use it. With Keywords empty, the live search reads its keywords from this page — one URL is enough to start." }, "senderPitch": { "title": "What you offer site owners (your pitch)", "type": "string", "description": "One line on what you bring — a guest article idea, a free tool, a guide worth listing. The opener and the pitch angle build on it, never on invented claims." }, "minScore": { "title": "Minimum fit score (0–100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "The field that decides what you pay: prospects whose fit score is below this are discarded and not charged. 70+ = pitch this week, 45–69 = maybe. Raise it to pay only for the strongest prospects, lower it to see more.", "default": 60 }, "maxQualified": { "title": "Max qualified prospects to output", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on results (and therefore on what you pay for). The best-scoring prospects are output first.", "default": 50 }, "maxDiscoveryChargeUsd": { "title": "Max Google search spend (USD)", "minimum": 0.01, "maximum": 1000, "type": "number", "description": "Hard cap on what the Google search (apify/google-search-scraper) may charge your account in actor mode: footprint queries that would cost more are dropped before the search starts. $0.50 in the form and for an API / agent call that leaves it out — your first real search can never cost more. Raise it for bigger searches.", "default": 0.5 }, "enableAi": { "title": "AI assessment", "type": "boolean", "description": "On = $0.018 per qualified prospect + AI tokens (≈ $0.005, billed through Apify's model access or your own key); off = $0.006. Per prospect the AI adds: opportunity type and a 0–100 fit score with verbatim quotes from the page, an outreach opener and a pitch angle that cite the page, and the site's submission rules (guest posts accepted, sponsored, link policy, topics). Off = the rule-based type, score and template opener.", "default": true }, "opportunityTypes": { "title": "Opportunity types", "type": "array", "description": "Which link opportunities to search for and deliver. Each type adds its own footprint searches; a prospect of a type you did not pick is dropped free. Unlinked mentions need Your brand name; Competitor mentions need Competitors (naming competitors switches it on).", "items": { "type": "string", "enum": [ "guest_post", "resource_page", "listicle", "review", "forum", "news", "unlinked_mention", "competitor_mention", "other", "any" ], "enumTitles": [ "Guest posts (write for us)", "Resource / links pages", "Listicles (best X tools, top 10)", "Reviews", "Forums & communities", "News articles", "Unlinked brand mentions", "Competitor mentions (they cover a competitor, not you)", "Other pages", "Any type" ] }, "default": [ "guest_post", "resource_page", "listicle" ] }, "minAuthority": { "title": "Minimum domain authority (0–100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Drop sites below this authorityScore — free, before the AI. The score is a log scale of the site's Tranco rank (top 1 000 ≈ 54, top 100 000 ≈ 23), or Open PageRank × 10 with your key. Sites outside Tranco's top 1M have no score and are dropped by any value above 0. 0 = keep every site.", "default": 0 }, "requireContactRoute": { "title": "Only prospects with an e-mail or contact page", "type": "boolean", "description": "On = a prospect without a public e-mail or a contact page is dropped free. Off = it is delivered with hasContactRoute: false.", "default": false }, "countryCode": { "title": "Google country", "type": "string", "description": "Two-letter country of the Google search (us, gb, de, in, au …) — prospects that rank where your buyers are.", "default": "us" }, "ownDomains": { "title": "Your own domains", "type": "array", "description": "Your sites (and their subdomains) — never delivered as prospects. Also used to tell whether a page already links to you.", "items": { "type": "string" } }, "ignoredDomains": { "title": "Domains to ignore", "type": "array", "description": "Competitors, sites you never pitch, sites you pitched outside this Actor. Dropped free, subdomains included.", "items": { "type": "string" } }, "brandName": { "title": "Your brand name", "type": "string", "description": "Checked on every page (title, snippet, text). With Unlinked brand mentions picked, pages that name you without linking become prospects; otherwise see the next field.", "default": "" }, "excludeBrandMentioned": { "title": "Drop pages that already mention your brand", "type": "boolean", "description": "On = a page that already names your brand is dropped free (you probably know it). Ignored when you pick Unlinked brand mentions.", "default": true }, "competitorNames": { "title": "Competitors (digital PR)", "type": "array", "description": "Brands or products you compete with. Each one adds a Google search for pages that name it but not Your brand name (\"Competitor\" -\"YourBrand\"); pages that mention a competitor and not you become competitor_mention prospects with the competitor in competitorsMentioned — the sites to ask for a spot next to them.", "items": { "type": "string" } }, "targetFlags": { "title": "Target flags (any of)", "type": "array", "description": "Only deliver prospects that have at least one of these flags, and rank those with more of them higher. Leave empty to keep everything. Use the flag names from the README's flag table, e.g. has_email or accepts_guest_posts (hasEmail works too); an unknown name stops the run at once with the list of valid ones.", "items": { "type": "string" } }, "suppressionList": { "title": "Exclude list", "type": "array", "description": "Domains or URLs to never output. Suppressed prospects are skipped before any processing and never charged.", "items": { "type": "string" } }, "findContactRoute": { "title": "Find the contact route on each site", "type": "boolean", "description": "Free: reads the prospect page and one of its contact / write-for-us pages (robots.txt honoured, max 2 pages per site) for public e-mails, the contact page, the guidelines page and social profiles. Off = faster, Google data only.", "default": true }, "checkEmails": { "title": "Check the e-mails and pick the best one", "type": "boolean", "description": "Free: checks that each e-mail's domain has a mail server (MX), marks shared inboxes (info@, contact@ …) and picks bestEmail — a named person first, then an editorial inbox — with emailStatus, isRoleAddress and firstName for Lemlist / Instantly. No mailbox (SMTP) verification.", "default": true }, "checkBrokenLinks": { "title": "Find dead links on resource pages and listicles", "type": "boolean", "description": "Free: checks the outbound links of every resource page / listicle prospect (HEAD request, max 15 per page). A link that answers 404 / 410 or whose domain is gone lands in brokenLinks, sets the has_broken_link flag and turns the opener into the broken-link pitch: \"the link to X on your page no longer works — my page could replace it\".", "default": true }, "lookupAuthority": { "title": "Look up domain authority", "type": "boolean", "description": "Free: authorityScore (0–100) and authorityRank per site from the Tranco top-1M ranking (one download per run, ≈ 2 s), or from Open PageRank when you add a key below. Off = no authority figures and Minimum domain authority is ignored.", "default": true }, "openPageRankApiKey": { "title": "Open PageRank API key (optional)", "type": "string", "description": "A free key from domcop.com/openpagerank adds a 0–10 PageRank for small sites too (Tranco only ranks the top 1M). Stored encrypted by Apify, never logged." }, "writeSequence": { "title": "AI writes the follow-up and break-up e-mails too", "type": "boolean", "description": "AI on only. Adds followUp (≤ 60 words, one new reason to reply) and breakUp (≤ 40 words) to every hot / warm prospect, grounded in the same page — a 3-step sequence ready for Lemlist / Instantly. Same event price; only a few more AI tokens.", "default": false }, "senderName": { "title": "Your name (optional)", "type": "string", "description": "Only used so the AI never invents a sender name — leave empty and the opener has none.", "default": "" }, "llmProvider": { "title": "AI model access", "enum": [ "apify", "byok" ], "type": "string", "description": "Apify (no keys) — the AI runs through Apify's built-in OpenRouter proxy; tokens are billed to your Apify account at OpenRouter's rates. My own key — use your OpenAI / Anthropic / Gemini / Groq key instead.", "default": "apify" }, "llmModel": { "title": "AI model", "type": "string", "description": "Leave empty for the default (anthropic/claude-haiku-4.5). Apify mode takes an OpenRouter slug such as openai/gpt-4.1-mini; own-key mode takes provider:model, e.g. anthropic:claude-haiku-4-5-20251001." }, "llmApiKey": { "title": "Your API key (own-key mode only)", "type": "string", "description": "Required when AI model access is My own API key. Stored encrypted by Apify, never logged." }, "aiCandidateMultiplier": { "title": "AI candidate pool (× max qualified)", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many of the best rule-scored prospects get the AI pass, as a multiple of Max qualified prospects. Higher = more thorough, slower, more tokens.", "default": 2 }, "notifyEmail": { "title": "E-mail me the new prospects (optional)", "type": "string", "description": "After every run with at least one new prospect, the run's digest (how many are new, the top 10 with their contact route) is e-mailed here through Apify's send-mail Actor. Schedule the run weekly and the prospects come to your inbox — no Slack or Zapier needed. Never sent for the free demo." }, "lemlistApiKey": { "title": "Lemlist API key", "type": "string", "description": "Adds every new prospect with a bestEmail to your Lemlist campaign after the run pushes it (firstName, companyName, website, the opener as icebreaker, the page, pitch angle and dead link as custom variables). Lemlist → Settings → Integrations → API. Stored encrypted by Apify, never logged." }, "lemlistCampaignId": { "title": "Lemlist campaign ID", "type": "string", "description": "The campaign the prospects are added to (cam_… from the campaign's URL). Duplicates are skipped by Lemlist." }, "instantlyApiKey": { "title": "Instantly API key (v2)", "type": "string", "description": "Adds every new prospect with a bestEmail to your Instantly campaign (email, first_name, company_name, website, the opener as personalization, custom variables). Instantly → Settings → Integrations → API keys. Stored encrypted, never logged." }, "instantlyCampaignId": { "title": "Instantly campaign ID", "type": "string", "description": "The campaign the prospects are added to (the ID in the campaign's URL). Leads already in your workspace are skipped." }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "Qualified prospects are POSTed here as JSON (Zapier, Make, n8n, your CRM or outreach tool). For Google Sheets / Slack you can also use Apify's built-in Integrations tab." }, "webhookHeaders": { "title": "Webhook headers (optional)", "type": "object", "description": "Extra HTTP headers for the webhook, e.g. {\"Authorization\": \"Bearer …\"}." }, "webhookBatchSize": { "title": "Webhook batch size", "minimum": 1, "maximum": 500, "type": "integer", "description": "1 = one POST per prospect the moment it is ready. Higher = one POST per N prospects.", "default": 1 }, "clients": { "title": "Clients (agency mode)", "type": "array", "description": "One run — one schedule — for all your clients. Each entry is one client's brief: name plus any of keywords, targetUrl, senderPitch, ownDomains, ignoredDomains, brandName, competitorNames, suppressionList, notifyEmail, lemlistCampaignId, instantlyCampaignId. Every other setting is shared. Each client gets its own search, its own never-twice memory, a client column (view By client), its own digest e-mail and campaign. Max 25 clients per run; maxQualified and maxDiscoveryChargeUsd apply per client." }, "dedupeAcrossRuns": { "title": "Never output the same domain twice", "type": "boolean", "description": "Remembers every domain you received (in a named key-value store on your account) and skips it — free — in future runs, whichever of its pages ranks next time.", "default": true }, "dedupeStoreName": { "title": "Dedupe store name", "type": "string", "description": "Key-value store used for cross-run memory. Left at the default, the memory is kept per client: a different targetUrl / ownDomains / brandName starts its own list, so one client never hides prospects from another. Type your own name to share one memory across clients, or to keep one per campaign.", "default": "link-building-prospects-ai-seen" }, "maxToProcess": { "title": "Max candidates to process", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Upper bound on how many Google results are checked in one run (controls run time). Default = 3 × max qualified." }, "searchLanguage": { "title": "Google language", "type": "string", "description": "Two-letter language of the results (en, de, fr, es …).", "default": "en" }, "maxPagesPerQuery": { "title": "Google pages per footprint query", "minimum": 1, "maximum": 10, "type": "integer", "description": "1 page = the top ~10 results of each footprint search ($0.0045 per page on your account). 2–3 digs deeper for niche keywords.", "default": 1 }, "quickDateRange": { "title": "Only pages from the last …", "enum": [ "any", "d7", "m1", "m6", "y1", "y2" ], "type": "string", "description": "Google's date filter — fresher pages, active sites.", "default": "any" }, "footprints": { "title": "Custom footprints", "type": "array", "description": "Your own operator searches, one per line; {keyword} is replaced by each keyword, e.g. \"{keyword}\" inurl:write-for-us or \"{keyword}\" \"guest contributor\". They run before the built-in ones.", "items": { "type": "string" } }, "maxQueries": { "title": "Max footprint queries per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Caps the number of Google searches (keywords × footprints). The cheapest control of your search spend.", "default": 40 }, "discoveryActorId": { "title": "Source Actor (advanced)", "type": "string", "description": "Actor used in actor mode. Any Actor whose output has the Google Search Results Scraper fields (organicResults or one result per row) works.", "default": "apify/google-search-scraper" }, "discoveryInput": { "title": "Extra source Actor input (advanced)", "type": "object", "description": "Merged into the Google Search Results Scraper input and wins over the Actor's own values — e.g. {\"websiteContentScraper\": true} to have the source scrape each page (then nothing is fetched here), or your own queries instead of the footprints." }, "proxyConfiguration": { "title": "Proxy for the contact-route fetch", "type": "object", "description": "Only for reading the prospects' own pages. Off by default — blogs rarely block a single polite request; switch Apify Proxy on if many fetches fail." }, "datasetId": { "title": "Dataset", "type": "string", "description": "Only for dataset mode. A Google Search Results Scraper dataset (one item per Google page with organicResults, or its one-result-per-row view). Pick the dataset so the Actor is granted read access to it." }, "itemsList": { "title": "Google results or URLs to process", "type": "array", "description": "Only for list mode. JSON array of URLs, or of objects with url and optionally title, description, position, query — e.g. an Ahrefs / Semrush / SERP export." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }