Suggest a page FAQ from the questions people ask

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"trail bike sizing","language":"en"}' \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/faq-suggest"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/faq-suggest", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…", "Content-Type": "application/json" },
  body: JSON.stringify({
    "keyword": "trail bike sizing",
    "language": "en"
  }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.post(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/faq-suggest",
    headers={"Authorization": "Bearer mr_ws_…"},
    json={
        "keyword": "trail bike sizing",
        "language": "en",
    },
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/faq-suggest");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…", "Content-Type: application/json"],
    CURLOPT_POSTFIELDS => '{"keyword":"trail bike sizing","language":"en"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.post(
  "https://app.monoranks.com/api/v1/sites/SITE_ID/pages/PAGE_ID/faq-suggest",
  {
    "keyword": "trail bike sizing",
    "language": "en"
  },
  { headers: { Authorization: "Bearer mr_ws_…" } },
);

{
  "page": {
    "id": "c7a9e1b3-5d7f-4b9c-8e1a-3c5e7a9b1d2f",
    "url": "https://acmebikes.com/guides/trail-bike-sizing/"
  },
  "suggestion": {
    "keyword": "trail bike sizing",
    "locationCode": 2840,
    "languageCode": "en",
    "suggestedAt": "2026-10-09T08:12:51.000Z",
    "results": {
      "date": "2026-10-09",
      "source": "live",
      "checkUrl": "https://www.google.com/search?q=trail%20bike%20sizing&num=10&hl=en&gl=US",
      "peopleAlsoAsk": [
        "How do I know what size trail bike I need?",
        "What size bike for 5'10?",
        "Is it better to size up or down on a mountain bike?"
      ],
      "relatedSearches": [
        "trail bike size chart",
        "mtb sizing calculator"
      ],
      "topPagesRead": [
        {
          "url": "https://ridgecycles.example/sizing",
          "domain": "ridgecycles.example",
          "read": true,
          "questions": 4
        },
        {
          "url": "https://trailhub.example/fit",
          "domain": "trailhub.example",
          "read": false,
          "questions": 0
        }
      ]
    },
    "pageText": "live",
    "questions": [
      {
        "question": "How do I know what size trail bike I need?",
        "askedBy": 3,
        "sources": [
          {
            "source": "paa",
            "from": null
          },
          {
            "source": "top_page",
            "from": "ridgecycles.example"
          },
          {
            "source": "search_console",
            "from": null
          }
        ],
        "wordings": [
          "How do I know what size trail bike I need?",
          "How do I choose my trail bike size?",
          "what size trail bike do i need"
        ],
        "answered": "yes",
        "answeringSentence": "Start from your height: riders from 170 to 180 cm usually fit a size M frame."
      },
      {
        "question": "Is it better to size up or down on a mountain bike?",
        "askedBy": 2,
        "sources": [
          {
            "source": "paa",
            "from": null
          },
          {
            "source": "top_page",
            "from": "ridgecycles.example"
          }
        ],
        "wordings": [
          "Is it better to size up or down on a mountain bike?",
          "Should I size up or down?"
        ],
        "answered": "partly",
        "answeringSentence": "Between two sizes, the smaller frame is easier to handle on tight trails."
      },
      {
        "question": "How much does a trail bike weigh?",
        "askedBy": 1,
        "sources": [
          {
            "source": "answer_gap",
            "from": null
          }
        ],
        "wordings": [
          "How much does a trail bike weigh?"
        ],
        "answered": "no",
        "answeringSentence": null
      }
    ],
    "suggestedFaq": [
      {
        "index": 0,
        "question": "How do I know what size trail bike I need?",
        "answer": "Start from your height: riders from 170 to 180 cm usually fit a size M frame.",
        "fromSentences": [
          "Start from your height: riders from 170 to 180 cm usually fit a size M frame."
        ]
      },
      {
        "index": 1,
        "question": "Is it better to size up or down on a mountain bike?",
        "answer": "Between two sizes, the smaller frame is easier to handle on tight trails.",
        "fromSentences": [
          "Between two sizes, the smaller frame is easier to handle on tight trails."
        ]
      }
    ],
    "addSection": [
      {
        "question": "How much does a trail bike weigh?",
        "heading": "How much our trail bikes weigh",
        "why": "AI answers to this question name other shops, never this one."
      }
    ],
    "reasonsLanguage": "en",
    "model": "claude-sonnet-4-6",
    "resultsCostUsd": 0.002
  },
  "cost": {
    "usd": 0.002,
    "lookups": 1,
    "reused": false,
    "pagesRead": 4
  },
  "aiNote": null,
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/pages/c7a9e1b3-5d7f-4b9c-8e1a-3c5e7a9b1d2f#faq-suggest"
}

{
  "error": {
    "code": "missing_argument",
    "message": "page_id or url is required."
  }
}

{
  "error": {
    "code": "missing_key",
    "message": "Send the key as Authorization: Bearer mr_site_…"
  }
}

{
  "error": {
    "code": "missing_scope",
    "message": "This key does not have the scope this call needs."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Page not found. Use a page_id from page_findings or list_pages, or the exact crawled url."
  }
}

{
  "error": {
    "code": "unsupported_location",
    "message": "Google results are not available for Iran, so \"People also ask\" cannot be read there.",
    "country": "Iran"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "More than 1200 requests this hour for this key."
  }
}

{
  "error": {
    "code": "failed",
    "message": "Google results could not be fetched right now. Try again in a few minutes."
  }
}

{
  "error": {
    "code": "no_provider",
    "message": "Google results are not available on this server yet."
  }
}