Mangools/API

Get keyword details

This endpoint returns details for a specified keyword.

With this endpoint you will get:

  • Keyword SEO difficulty
  • Organic SERP results with essential metrcis
  • Number of results in SERP
  • Click-through rates for each organic position

Limits

Each request is counted towards to your SERP lookups limit. Lookup is not counted if you make the identical request within 24 hours.

GET
/kwfinder/serps

Authorization

ApiKeyAuth
x-access-token<token>

API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.

In: header

Query Parameters

location_id?integer

ID of location, default 2840

language_id?integer

ID of language_id

platform_id?integer

ID of platform_id, default 0

page?integer

page, default 0

kw*string

keyword

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.mangools.com/v3/kwfinder/serps?kw=example"
{
  "_id": "aa93adafb6466917d51dc3bf836d32da",
  "kw": "seo specialist",
  "kwId": "aa93adafb6466917d51dc3bf836d32ds",
  "page": 0,
  "location_id": 2840,
  "location": {
    "_id": 1000,
    "name": "string",
    "country_code": "string",
    "canonical_name": "string",
    "code": "us",
    "label": "New York,United States",
    "google_domain": "string",
    "type": 0,
    "tld": "us",
    "active": true,
    "created_at": 1588773715,
    "parent_id": 2840,
    "status": "Active",
    "target_type": "State"
  },
  "platform_id": 1,
  "parserType": 0,
  "items": [
    {
      "type": "SIMILAR_QUESTIONS",
      "size": {
        "t": 828.859375,
        "l": 180,
        "b": 1052.859375,
        "r": 832
      },
      "screenCoverage": 0,
      "visPart": 0
    },
    {
      "type": "ORGANIC",
      "url": "https://en.wikipedia.org/wiki/Monitoring",
      "title": "Monitoring - Wikipedia",
      "desc": "Monitoring (medicine), the observation of a disease, condition or one or several medical parameters over time · Baby monitoring · Biomonitoring, of toxic chemical ...",
      "size": {
        "t": 1092.859375,
        "l": 180,
        "b": 1212.859375,
        "r": 780
      },
      "domain": "wikipedia.org",
      "topRank": 13,
      "m": {
        "fb": {
          "v": {
            "l": null,
            "og": null
          },
          "ts": 1617190715
        },
        "moz": {
          "v": {
            "ueid": 1138,
            "feid": 4173623975,
            "uifq": 341,
            "uipl": 341,
            "uid": 1428,
            "fid": 5448336,
            "pid": 5451274,
            "umrp": 7,
            "umrr": 0.6999999881,
            "fmrp": 9.794718742,
            "fmrr": 0.9794718623,
            "pmrp": 9.800000191,
            "pmrr": 0.9800000191,
            "utrp": 7,
            "utrr": 0.6999999881,
            "ftrp": 9.794718742,
            "ftrr": 0.9794718623,
            "ptrp": 9.800000191,
            "ptrr": 0.9800000191,
            "uemrp": 6.926956177,
            "uemrr": 0.6926956177,
            "fejp": 8.637768745,
            "fejr": 0.8637768626,
            "pejp": 8.642565727,
            "pejr": 0.8642565608,
            "pjp": 9.800000191,
            "pjr": 0.9800000191,
            "fjp": 9.794718742,
            "fjr": 0.9794718623,
            "flan": "",
            "fspf": 0,
            "fsplc": 0,
            "fspp": "",
            "fsps": 0,
            "fspsc": 2,
            "fem": "",
            "ffb": "",
            "fg+": "",
            "ftw": "",
            "us": 200,
            "fuid": 5412916321,
            "puid": 5413572992,
            "fipl": 5448336,
            "upa": 70,
            "pda": 98,
            "ued": 1416,
            "fed": 4853897084,
            "ped": 4854553705,
            "pib": 5451274,
            "ulc": 1606089600
          },
          "ts": 1617190715
        },
        "majestic": {
          "v": {
            "Status": "Found",
            "ExtBackLinks": 441,
            "RefDomains": 152,
            "AnalysisResUnitsCost": 441,
            "ACRank": 2,
            "RefIPs": 99,
            "ItemType": 3,
            "RefSubNets": 97,
            "CitationFlow": 16,
            "TrustFlow": 10,
            "TrustMetric": 10,
            "IndexedURLs": 1,
            "NonUniqueLinkTypeHomepages": "8",
            "NonUniqueLinkTypeIndirect": "228",
            "NonUniqueLinkTypeDeleted": "26",
            "NonUniqueLinkTypeNoFollow": "209",
            "NonUniqueLinkTypeProtocolHTTPS": "237",
            "NonUniqueLinkTypeFrame": "0",
            "NonUniqueLinkTypeImageLink": "11",
            "NonUniqueLinkTypeRedirect": "0",
            "NonUniqueLinkTypeTextLink": "436",
            "TotalNonUniqueLinks": "447",
            "OutLinksInternal": "",
            "OutLinksExternal": "",
            "OutDomainsExternal": "",
            "RefDomainsEDU": 0,
            "ExtBackLinksEDU": 0,
            "RefDomainsGOV": 0,
            "ExtBackLinksGOV": 0,
            "RefDomainsEDU_Exact": 0,
            "ExtBackLinksEDU_Exact": 0,
            "RefDomainsGOV_Exact": 0,
            "ExtBackLinksGOV_Exact": 0
          },
          "ts": 1617190715
        },
        "rank": {
          "v": {
            "r": 55
          },
          "ts": 1617190715
        }
      }
    }
  ],
  "browser": {
    "doc": {
      "w": 1366,
      "h": 3213
    },
    "view": {
      "w": 1366,
      "h": 768
    }
  },
  "rank": 39,
  "rank_updated_at": 1592618403,
  "created_at": 1592618403,
  "ctr": [
    0.1
  ],
  "results": 2360000000,
  "serp_results": null,
  "serp_snapshot_id": "58dc27755a3518edf5bb650abadf22d1.2021-03-31",
  "serp_source_url": "https://s3.amazonaws.com/mangools-google-pages/58dc27755a3518edf5bb650abadf22d1.2021-03-31.html",
  "serpFeaturesImpact": 2
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "ValidationError",
    "message": "Your request is invalid",
    "errors": [
      "\"kw\" is required"
    ]
  }
}
{
  "error": {
    "type": "RateLimit",
    "message": "Not enough limits 2"
  }
}