SearchByKeyword

Status

Command status: Active
Supported by OpenApps API: Yes
Supported by Internal/Reseller API: Yes
Possibly queued processing: No

Purpose

This command returns search data for a given keyword.

Note: This query has a maximum query rate of 3 requests per second per API account.

Resources consumed

Resource Description

AnalysisResUnits

1000

RetrievalResUnits

Actual number of rows of data returned

IndexItemInfoResUnits

Actual number of rows of data returned

Parameters

Parameter Description

cmd

Required: must be set to: SearchByKeyword.

query

Required: The keyword to search for.

scope

0 - returns Root Domains
2 (default) - returns URLs

from

(optional) Where to start the results from.
Min = 0 (default)
Max = 1000

count

10 (default) - How many results to retrieve.
Min = 1
Max = 20

Example queries and response

XML response

<?xml version="1.0" encoding="UTF-8"?>
<Result Code="OK" ErrorMessage="" FullError="">
<GlobalVars IndexBuildDate="2017-10-17 20:51:37" IndexType="1" ServerBuild="2017-10-13 13:57:22" ServerName="ECHOLIMA" ServerVersion="1.0.6495.23321" UniqueIndexID="20171017205137-FRESH" />
<DataTables Count="2">
<DataTable Name="Results" RowsCount="10" Headers="RankID|Item|Title|SearchScore|ScoreInTitle|ScoreInURL|ScoreInAnchor|ScoreOther|ScoreMultiplier|CitationFlow|TrustFlow|RefDomains|ExtBackLinks|TopicalTrustFlow_Topic_0|TopicalTrustFlow_Value_0|TopicalTrustFlow_Topic_1|TopicalTrustFlow_Value_1|TopicalTrustFlow_Topic_2|TopicalTrustFlow_Value_2" Count="10" From="0" GeoTarget="uk" GeoTargetSource="Client IP - 195.191.106.73" Matches="10419569" MatchesAfterFilter="10419569" MaxTargetTopics="30" MaxTargetTopicsRootDomains="30" MaxTargetTopicsSubDomains="20" MaxTargetTopicsURLs="10" Query="majestic" Scope="2" TargetTopicsCount="3">
<Row>0|https://majestic.com/|Majestic®: Marketing Search Engine and SEO Backlink Checker|11343|141|2257|8488|457|1.000|63|52|8077|2376872|Computers/Internet/Web Design and Development|43|Shopping/Antiques and Collectibles|39|Reference/Museums|39</Row>
<Row>1|http://www.majestic.co.uk/|Majestic Wine - Buy Wine &amp; Champagne Online|5801|129|1516|3698|458|1.000|41|52|1465|118123|Recreation/Food|52|Regional/Europe|31|Business|30</Row>
<Row>2|http://www.majesticseo.com/|Majestic®: Marketing Search Engine and SEO Backlink Checker|4406|112|0|3939|355|1.000|50|47|4200|337475|Shopping/Antiques and Collectibles|39|Reference/Museums|38|Regional/Europe|37</Row>
<Row>3|http://www.majesticproducts.com/|Majestic Products: Fireplaces &amp; Home Hearth|3918|119|0|3486|313|1.000|42|39|497|4017|Business/Construction and Maintenance|36|Business|35|Shopping|24</Row>
<Row>4|http://majestic12.co.uk/bot.php|Majestic-12 : DSearch : MJ12bot|3379|272|0|2693|414|1.000|63|42|15733|799425|Computers/Software/Operating Systems|36|Arts/Music|29|Computers/Internet/Web Design and Development|29</Row>
<Row>5|http://www.majestic.nl/| |3344|0|860|2212|272|1.000|34|31|115|2950|Business/Hospitality|30|Business/Industrial Goods and Services|27|Regional/Europe|19</Row>
<Row>6|http://www.majestic.sk/| |3026|0|867|1947|212|1.000|34|29|153|65905|Arts/Music|29|Business/Arts and Entertainment|21|Recreation/Travel|16</Row>
<Row>7|http://www.majestic-percussion.com/|Majestic|3001|431|519|1792|259|1.000|35|34|134|9348|Arts/Music|34|Regional/Europe|21|World/Deutsch|18</Row>
<Row>8|http://www.majestic.org/| |2917|0|985|1678|254|1.000|31|40|161|589|Arts|40|Arts/Performing Arts|24|Regional/North America|23</Row>
<Row>9|https://twitter.com/Majestic/|Majestic (@Majestic) || Twitter|2878|165|247|1833|633|1.000|57|31|65|287157|Computers/Internet/Web Design and Development|29|Computers/Computer Science/Distributed Computing|24|Reference/Education|24</Row>
</DataTable>
<DataTable Name="MiscInfo" RowsCount="6" Headers="Name|Value|Type">
<Row>FirstResultScoreTotal|11343|0</Row>
<Row>FirstResultScoreInTitle|141|0</Row>
<Row>FirstResultScoreInURL|2257|0</Row>
<Row>FirstResultScoreInAnchor|8488|0</Row>
<Row>FirstResultScoreOther|457|0</Row>
<Row>FirstResultScoreMultiplier|1.000|1</Row>
</DataTable>
</DataTables>
</Result>

JSON response

{
  "Code": "OK",
  "ErrorMessage": "",
  "FullError": "",
  "IndexBuildDate": "2017-09-04 13:42:54",
  "IndexType": 0,
  "ServerBuild": "2017-10-13 13:57:22",
  "ServerName": "SHADOJAGUAR",
  "ServerVersion": "1.0.6495.23321",
  "UniqueIndexID": "20170904134254-HISTORICAL",
  "DataTables": {
    "AnchorText": {
      "Headers": {
        "CanReturnURLs": 0,
        "Count": 10,
        "FilterAnchorText": "majestic",
        "FilterAnchorTextMode": 0,
        "FilterRefDomain": "",
        "From": 0,
        "Item": "majestic.com",
        "MaxTopics": 10,
        "Mode": 0,
        "OrigItem": "majestic.com",
        "TextMode": 0,
        "TopicsCount": 3,
        "TotalBackLinks": 42000276,
        "TotalRefDomains": 123478,
        "TotalResults": 483
      },
      "Data": [
        {
          "AnchorText": "majestic seo",
          "RefDomains": 10758,
          "TotalLinks": 2313917,
          "DeletedLinks": 308508,
          "NoFollowLinks": 462389,
          "EstimatedLinkCitationFlow": 46,
          "EstimatedLinkTrustFlow": 30,
          "TopicalTrustFlow_Topic_0": "Business",
          "TopicalTrustFlow_Value_0": 26,
          "TopicalTrustFlow_Topic_1": "Business/Marketing and Advertising",
          "TopicalTrustFlow_Value_1": 24,
          "TopicalTrustFlow_Topic_2": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_2": 24
        },
        {
          "AnchorText": "majestic",
          "RefDomains": 5323,
          "TotalLinks": 1301447,
          "DeletedLinks": 197469,
          "NoFollowLinks": 117462,
          "EstimatedLinkCitationFlow": 55,
          "EstimatedLinkTrustFlow": 37,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_0": 34,
          "TopicalTrustFlow_Topic_1": "Business/E-Commerce",
          "TopicalTrustFlow_Value_1": 33,
          "TopicalTrustFlow_Topic_2": "Computers/Computer Science/Distributed Computing",
          "TopicalTrustFlow_Value_2": 33
        },
        {
          "AnchorText": "majesticseo",
          "RefDomains": 3163,
          "TotalLinks": 734424,
          "DeletedLinks": 188867,
          "NoFollowLinks": 307809,
          "EstimatedLinkCitationFlow": 38,
          "EstimatedLinkTrustFlow": 30,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Domain Names",
          "TopicalTrustFlow_Value_0": 27,
          "TopicalTrustFlow_Topic_1": "Society/Disabled",
          "TopicalTrustFlow_Value_1": 25,
          "TopicalTrustFlow_Topic_2": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_2": 25
        },
        {
          "AnchorText": "www.majesticseo.com",
          "RefDomains": 2224,
          "TotalLinks": 50274,
          "DeletedLinks": 29921,
          "NoFollowLinks": 15181,
          "EstimatedLinkCitationFlow": 30,
          "EstimatedLinkTrustFlow": 17,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Searching",
          "TopicalTrustFlow_Value_0": 16,
          "TopicalTrustFlow_Topic_1": "Computers/Computer Science/Distributed Computing",
          "TopicalTrustFlow_Value_1": 15,
          "TopicalTrustFlow_Topic_2": "Business/Employment",
          "TopicalTrustFlow_Value_2": 15
        },
        {
          "AnchorText": "majestic.com",
          "RefDomains": 1937,
          "TotalLinks": 106911,
          "DeletedLinks": 24330,
          "NoFollowLinks": 83468,
          "EstimatedLinkCitationFlow": 52,
          "EstimatedLinkTrustFlow": 32,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_0": 29,
          "TopicalTrustFlow_Topic_1": "Reference/Education",
          "TopicalTrustFlow_Value_1": 28,
          "TopicalTrustFlow_Topic_2": "Business",
          "TopicalTrustFlow_Value_2": 24
        },
        {
          "AnchorText": "http://www.majesticseo.com/",
          "RefDomains": 1786,
          "TotalLinks": 20324,
          "DeletedLinks": 11074,
          "NoFollowLinks": 6101,
          "EstimatedLinkCitationFlow": 24,
          "EstimatedLinkTrustFlow": 19,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_0": 19,
          "TopicalTrustFlow_Topic_1": "Computers/Internet",
          "TopicalTrustFlow_Value_1": 12,
          "TopicalTrustFlow_Topic_2": "Regional/Europe",
          "TopicalTrustFlow_Value_2": 10
        },
        {
          "AnchorText": "majestic-seo",
          "RefDomains": 1237,
          "TotalLinks": 21555,
          "DeletedLinks": 4644,
          "NoFollowLinks": 1986,
          "EstimatedLinkCitationFlow": 32,
          "EstimatedLinkTrustFlow": 28,
          "TopicalTrustFlow_Topic_0": "Computers/Computer Science/Distributed Computing",
          "TopicalTrustFlow_Value_0": 28,
          "TopicalTrustFlow_Topic_1": "Recreation/Radio",
          "TopicalTrustFlow_Value_1": 18,
          "TopicalTrustFlow_Topic_2": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_2": 12
        },
        {
          "AnchorText": "http://www.majesticseo.com",
          "RefDomains": 1118,
          "TotalLinks": 49342,
          "DeletedLinks": 16679,
          "NoFollowLinks": 7887,
          "EstimatedLinkCitationFlow": 19,
          "EstimatedLinkTrustFlow": 20,
          "TopicalTrustFlow_Topic_0": "Business/Marketing and Advertising",
          "TopicalTrustFlow_Value_0": 20,
          "TopicalTrustFlow_Topic_1": "Computers/Computer Science/Distributed Computing",
          "TopicalTrustFlow_Value_1": 15,
          "TopicalTrustFlow_Topic_2": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_2": 12
        },
        {
          "AnchorText": "majesticseo.com",
          "RefDomains": 992,
          "TotalLinks": 29905,
          "DeletedLinks": 5055,
          "NoFollowLinks": 16261,
          "EstimatedLinkCitationFlow": 27,
          "EstimatedLinkTrustFlow": 24,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_0": 24,
          "TopicalTrustFlow_Topic_1": "Society/Law",
          "TopicalTrustFlow_Value_1": 16,
          "TopicalTrustFlow_Topic_2": "Computers/Programming/Languages",
          "TopicalTrustFlow_Value_2": 14
        },
        {
          "AnchorText": "majestic site explorer",
          "RefDomains": 439,
          "TotalLinks": 55449,
          "DeletedLinks": 1878,
          "NoFollowLinks": 8600,
          "EstimatedLinkCitationFlow": 22,
          "EstimatedLinkTrustFlow": 17,
          "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development",
          "TopicalTrustFlow_Value_0": 15,
          "TopicalTrustFlow_Topic_1": "Computers/Software/Business",
          "TopicalTrustFlow_Value_1": 15,
          "TopicalTrustFlow_Topic_2": "Recreation/Radio",
          "TopicalTrustFlow_Value_2": 14
        }
      ]
    }
  }
}

Returned values

Return value Description
Global variables
Code Code indicating if this command executed successfully.
ErrorMessage A message explaining the error. This will be blank if the code is "OK".
FullError Verbose explanation of error.
IndexBuildDate Date/time the index that was queried was last updated.
IndexType Indicates if the index was Historic (0) or Fresh (1).
ServerBuild Date/time the server was built.
ServerName Name of the server queried.
ServerVersion Version of the server queried.
UniqueIndexID Unique identifier for the index consisting of the date and index type.
AnchorText Headers
CanReturnURLS Boolean indicating if this can return URLs.
Count Number of anchor texts returned.
FilterAnchorText Parameter to filter anchor texts by.
FilterRefDomain Parameter to filter referral domains by.
From Starting point in the results to return from.
Item Item to search for anchor text linking to.
OrigItem Item as passed in as a parameter.
TopicsCount Number of topical trust flow topics to be returned with each anchortext object.
TotalBackLinks Total number of backlinks to this page from anchor text.
TotalRefDomains Total number of domains that refer to this item.
TotalResults Total number of anchor texts which link to this item.
AnchorText Data
AnchorText Anchor text value.
RefDomains Number of domains which refer to the item with this anchor text.
TotalLinks Number of links which refer to the item with this anchor text.
DeletedLinks Number of links which referred to the item until they were deleted.
NoFollowLinks Number of links which refer to this item and are marked as NoFollow.
EstimatedLinkCitationFlow Estimated Citation Flow for this anchor text link.
EstimatedLinkTrustFlow Estimated Trust Flow for this link.
TopicalTrustFlow_Topic(x) Trust flow topic.
TopicalTrustFlow_Value(x) Trust flow value.