Mangools API Documentation

Use this endpoint to get a detailed SERP with all its features.

With this endpoint you will get:

items - List of organic and paid results for a given keyword along with other SERP features (rich snippets)
URL, title, description and CTR for each organic result
50 SEO metrics (from MOZ, Majestic, FB...) for each organic result (URL)
Link to the actual SERP preview (stored for 30 days)
SERP features impact metric
"Above the fold" visibility of a specific item (screenCoverage - % of screen does it take & visPart - % of visible part)
Total number of results for a specific search query in search

Locations

Specify the location_id to get localized SERPs. Don't forget that you can localize down to the city level!

To get a list of supported locations, please refer to this article.

Enumeration of Rich snippet items in response

Here is the list of all possible rich snippets, or SERP features, we detect. If you are not familiar with them, you can read more about them on our blog.

SPELL_ERROR
SUGGESTION
KNO_GRAPH
KNO_GRAPH_LINK
TOP_CAROUSEL
TOP_STORIES
ADV_TOP
ADV_BOTTOM
NEWS_CAROUSEL
NEWS_PACK
IMG_PACK
VIDEO_PACK
FLIGHTS
VIDEO_PANEL
INSTALL_APP
INSTALL_APP_GRID
LOCAL_PACK
PROGRAM_OVERVIEW
ORGANIC
SIMILAR_QUERIES
SIMILAR_ENTITIES
SIMILAR_ENTITIES2
SIMILAR_QUESTIONS
SPECIFY_QUERY
SIMILAR_PLACES
POPULAR_LIST
QUANTITY_ANSWER
CURRENCY
TIME
FEATURED_SNIPPET
WEATHER
TRANSLATOR
DICTIONARY
TOP_SIGHTS
TRAVEL_BOX
INDEPTH_ARTICLE
SHOP_RESULTS
JOB_POSTING
SPORTS

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

location ID - 0 for any

kw*string

Keyword

platform_id?integer

Platform: 1 = desktop (default), 2 = mobile

Default1

Value in1 | 2

Response Body

`application/json`

curl -X GET "https://api.mangools.com/v3/serpchecker/serps?location_id=0&kw=string"

{
  "_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"
  }
}

Get SERP results w. all metrics + snapshot

Locations

Enumeration of Rich snippet items in response

Authorization

Query Parameters

Response Body

200application/json

401application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`