CUSTOMER MANUAL
October 10, 2014
Version 5.1
2
TABLE OF CONTENTS
TABLE OF CONTENTS
2
Overview
3
How to Get Started
3
Define Traffic
3
Add Websites
4
Managing Your Analysis Groups
5
How to setup scheduled Re-Crawls
5
How to setup Market Brew Rules™
5
Prediction Model
6
Prediction Data
7
Algorithms
8
Simulations
9
Link Flow
10
Historical Reporting
13
Reach Share
13
Traffic-Producing Keyword
14
Link Flow
14
APPENDIX
15
How to View/Edit your Customer Information
15
How to View and Manage your Child Account Information
15
Prediction Data Screens
16
Market Brew Rules
17
How to Use Market Brew API Web Services
23
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
3
Overview
Market Brew™ is a predictive platform for organic search rankings. It is designed for both novice and
experienced users. It can simulate any competitive environment with great precision, exposing search
ranking distances and predicting the winners and losers within your competitive environment.
How to Get Started
When you first login to Market Brew, you will be at your DEFAULT Analysis Group screen. You can have
multiple Analysis Groups, simulating different competitive environments.
Define Traffic
The first thing you want to do for an Analysis Group is to define the total possible traffic for this
competitive environment. Click on Define Traffic and add all possible keywords that this group will be
competing for.
Keywords can be any length – they represent what users would be entering on a search engine like
Google. Market Brew will pull in the estimated traffic as reported directly from major search engines.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
4
Unless you are trying to simulate a specific scenario, it is usually important that you define all possible
keywords / queries that represent 100% of your total potential organic traffic.
Add Websites
Next, add the competitive sub-domains that will be modeled in this Analysis Group. You do NOT have to
add every competitive website. Only a representative sample of the websites that are mostly above your
target website should be needed for an accurate model. While Market Brew can compare as many
websites as you need, you will find that it is much more cost efficient to analyze a smaller statistical
sample, and very little gain in precision occurs beyond a specific amount of inputted data.
Once you have setup your traffic and websites, your Analysis Group will look like the above screenshot.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
5
Managing Your Analysis Groups
It is important to make sure that all of your websites have some sort of re-crawl strategy setup.
How to setup scheduled Re-Crawls
To setup a re-crawl schedule, simply click on show all actions and then click Manage Scheduled Crawls.
Typically the target website (the one that you are optimizing) should be re-crawling at a slightly faster
rate than the competitive websites.
How to setup Market Brew Rules™
Once you have optimized something, Market Brew allows you to “set it and forget it” using a rulesbased engine.
Whenever a website is re-crawled, each rule that was defined for that website is evaluated. If the rule
condition is TRUE, then an email alert is sent instantly.
Market Brew makes it very easy to create simple rules. When logged in, simply click on any
to the item you wish to create a rule with.
icon next
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
6
Then, you simply follow Market Brew Rules Wizard. Select your condition, (optionally) enter a value,
name the rule, and you're done! Market Brew Rules are fired off only after a Website has been recrawled.
Prediction Model
Inside Market Brew is a search engine that is modeled off of over a decade of regression testing and
curve-fitting. The model can be customized, however, with your own data. This allows each Analysis
Group to be more precisely fit to your local environment.
While it is not required that you dive into the prediction model, it is beneficial to understand how it
works, so you can better anticipate answers to optimization problems that will arise.
To see the prediction model data, click on Simulate a Search on the Analysis Group screen:
You will see a screen, which looks very familiar. It’s a search engine emulator, based on the prediction
model that is currently loaded.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
7
Typing in any keyword, you can see how that model behaves. You can hover over the Query Score to see
the sub-score breakdown:
…or click on one of the metrics like Market Focus, Net Total Link Flow, or Market Brew Score.
Prediction Data
Once all of your traffic-producing keywords and websites have been put into the Analysis Group, you
will receive 3 major summary screens for each website:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
8
1) Algorithms – will reveal how the Market Brew search engine model applied its algorithms to
each website, webpage, and link.
2) Simulations – Market Brew runs millions of “what-if” simulations for all websites in the defined
Analysis Group, and can determine which optimizations would give the highest increase in clickthrough rate for the least amount of effort. An Optimization Score is presented which can be
used to determine the highest ROI moves.
3) Link Flow – one of the major components of a search ranking is the link graph component, or
how other websites are linking to the target website, and websites around the target website.
The Link Flow screen reveals this link graph, where the Link Flow™ goes once it arrives at the
target website.
Algorithms
Click on the “A” next to the website in the Analysis Group:
You can see the summary of what your algorithmic penalties have done to your bottom line.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
9
Simulations
Click on the “S” next to the Website in the Analysis Group:
You will see your top keyword / webpage combinations to optimize.
Click on the Optimization Score to see WHAT to optimize:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
10
From here you can inspect how easy or hard it will be to get to the desired ranking position. If you want
to see a breakdown of the Query Score, simply scroll down to see each sub-score:
Link Flow
Click on the “L” next to the Website in the Analysis Group:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
11
A view of the website’s internal Link Flow Distribution will be presented, along with current/actual
values vs. targeted keywords.
This screen will show you which webpages, structurally, should be positioned in the link graph of that
website. Typical one is shown above. The keyword lawyer is way more competitive than most of the
keywords in the Analysis Group. Therefore, it stands to reason that one webpage in the website should
have a commensurate amount of Link Flow Distribution as well.
Flat Distributions – a Common Mistake
From roughly 2007 to present, it has been very customary to create mega menus that contain links to
almost every page in the website. Menus with 40+ items are not uncommon today. However, search
engines have maintained their algorithm that similar webpages are measured against each other via the
link graph calculation.
The problem? With a navigation design like this, the Link Flow Distribution gets very flat (lower value).
When this happens, search engines will think the privacy policy page is just as important as the product
page. Since the website will NEVER rank for privacy policy, it has effectively thrown away 50% of the
Link Flow for the product page.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
12
Therefore, it is very smart to ensure as much of a 1:1 relationship between the keywords you are
targeting, and the webpages that exist in the website. The Link Flow Distribution screen shows you how.
As a rough estimate, try to maintain 4-7 top pages (significantly more Link Flow % than the rest) until
you are ranking well for those. Then you can start adding sub-categories, once you have developed
enough incoming Link Flow to the website (called the website’s “Gross Total Link Flow”).
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
13
Historical Reporting
Market Brew maintains a historical “tick chart” view of every “iteration”, or re-crawl, of your Analysis
Group. It therefore represents a powerful tool to regression test, debug changes, and predict future
behavior on a search engine.
Reach Share
Once your Analysis Group has been calculated, each website will receive a specific amount of reach
estimate from the total possible reach estimate.
You can click on the graph next to Reach Share to reveal a tick chart of past Reach Shares for that
website. Click on additional websites to compare.
You can also view the movement in rankings at a more granular level by clicking through to see the
types of keywords that are being ranked.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
14
Traffic-Producing Keyword
Market Brew also keeps historical data on the traffic-producing keyword that you are using to model the
Analysis Group with. Click on the keyword to reveal the historical rankings:
You will see a tick chart for all websites within the Analysis Group:
Link Flow
Every website has a tick chart for Internal Link Flow Distribution:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
15
APPENDIX
How to View/Edit your Customer Information
Navigate to the Customer Home and click on the Edit Settings button.
You will be presented with Market Brew Settings Screen. From here, you can edit the various settings
used in your account.
View Transactions
From your Customer Home, click on the value for # Links Remaining, or the View Transaction History
link.
From here, you can select and view the various transactions that have occurred.
How to View and Manage your Child Account Information
If you have a Child Customer, you will be able to view and manage your Child Customer Account directly
from your Customer Home. Simply click on View Child Accounts on the View Info tab on your customer
home screen.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
16
Click on a Customer to drill-down into their Customer Info, where you can enable/disable the Customer
Account by selecting the Disable/Enable This Customer button. You can also view their Transaction
History by clicking on the View Transaction History button.
Prediction Data Screens
Market Brew is broken down into two critical areas:
•
•
On-Page Analysis
o Market Brew provides detailed information about a particular subdomain and the
immediate neighboring Websites. It is essentially an “on-demand” personal Search
Engine. You can gain complete insight into how any Search Engine will view a particular
Webpage and/or Link. It is crucial that On-Page optimization happen before spending
any marketing dollars on Off-Page optimization. This is because On-Page factors control
the efficiency of the Off-Page optimization.
Off-Page Analysis
o Market Brew provides detailed information about the structure of the Internet. If you
need to find a particular Website’s Incoming Links (Backlinks), or need to find the best
sources to obtain a particular Incoming Link, Off-Page optimization will help you do that.
On-Page Analysis
Your goal should be to master the primary screens in the On-Page Analysis area of Market Brew and
how to navigate between them to quickly and efficiently find and correct problems uncovered by
Market Brew:
1. Search Listing – Every Website on the Internet has one. This view is accessed by entering a URL
into the Search Bar at the top of any of the above screens. This view resembles the
conventional Search Engine Results Pages (SERPs), which allow you to quickly search for a
particular set of keywords. The results listings have links into the corresponding Webpage
Scoresheets and Scorecards of each Webpage displayed.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
17
2. Webpage Scoresheet – Every Webpage on the Internet has one. Shows on-page penalties,
errors, and warnings, as well as various critical pieces of data like Market Focus(TM), Link
Loss(TM), and much more.
3. Webpage Snapshot – Every Webpage on the Internet has one. Similar to Google’s “cached”
view, the Webpage Snapshot also allows Market Brew to overlay various information found
throughout Market Brew interface. For example, when viewing Dangling Links on the Link
Listing page, you can also get a Snapshot View of these Links by clicking the Snapshot View icon.
4. Webpage Scorecard – Every Webpage on the Internet has one. Shows on-page and off-page
penalties, errors, and warnings, and details out the exact formulas that were used to determine
that Webpage’s Market Brew Score(TM).
5. Market Focus Details – Every Webpage on the Internet has one. Shows how the Search Engine
views the content on that Webpage. It is a complete breakdown off contributing factors that
caused the Search Engine to determine what that Webpage is about.
6. Link Listings – These exist on both the Webpage and Website level. Link listings are like Search
Results, but each result is a Link, with all information regarding that Link summarized in a
dropdown list.
7. Link Scorecards – Every Link on the Internet has one. Shows a detailed breakdown of how the
Search Engine determined the Link Flow(TM) for that particular Link, in context with all of the
other Links on and around that Webpage.
8. Page Listings – These exist on both the Webpage and Website level. Page listings are like Search
Results, but they show specific categories of information.
9. Website Dashboard – Each sub-domain on the Internet has one. This is the “top level” of the
screens presented here for a given Website. All aggregate information regarding a Website is
presented here.
Market Brew Rules
The following standard operators can be used in a Market Brew Rule. Note, all Text should be enclosed
with double quotes ("").
Power
Boolean Not
Boolean And
Boolean Or
Less or Equal, More or Equal
Less Than, Greater Than
Not Equal, Equal
Assignment
Unary Plus, Unary Minus
Dot product, cross product
Modulus
Division
Multiplication
Addition, Subtraction
Operator
^
!
&&
||
<=, >=
<, >
!=, ==
=
+x, -x
., ^^
%
/
*
+, -
Numeric
Text
(only +)
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
18
Adding Custom Market Brew Rules
You don't have to just use Market Brew Rules Wizard. You can define your own customized
equations/conditions to your own liking.
On the Edit Rules screen, you can select any available piece of information in Market Brew to create
simplest or the most complex rule you can imagine.
Below are some simple examples of what you can do with Market Brew Rules. Using any of the
operators above, you can combine any piece of data for a Website, and come up with a new and
customized alert system. The combinations are endless — only your imagination holds you back.
•
Check to see whether or not a Website has any Broken Links:
numBrokenLinks > 0
•
Check to see whether or not a specific Webpage has issues loading on the Web Server. You may
be having issues with your Hosting Provider and want to know if the Webpage load times are
sufficient enough for your user experience / SLA:
retrieveTimeMillis > 5000
•
Check to see whether or not a Webpage's Market Brew Score has fallen below 85.5%. Let's
assume that a particular Webpage has been optimized and now has a Market Brew Score of
85.5%. You want to know if something changes which cause the Webpage to have more
penalties and a lower score:
seoengScore < 85.5
•
Check to see whether or not a Webpage's Market Focus is no longer "search engine
optimization". This would let you know when an edit on a Webpage accidently changes your
Market Focus(TM), thus causing your target keywords to drop in ranking:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
19
marketFocus != "search engine optimization"
•
Check to see whether or not a Link's net Link Flow Share drops below a threshold. You might
want to know when a Link that you have on another Website is of no longer use:
(netLinkFlowPercent/100) * linkFlow < 25.75
Manage Market Brew Rules
Simply click on the show actions link and select the Manage Market Brew Rules action link.
The list displays your Market Brew Rules for each Webpage and also shows rules created for the
Website as a whole.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
20
You may drill-down into each Webpage’s rules, or manage your Scheduled Crawls directly from this
view.
Click on any Market Brew Rule(TM) to enter the Edit Rule screen. In this screen, you may modify your
rule, delete your rule, or test different changes to the rule to see if it would fire or not.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
21
Off-Page Analysis
The Off-Page Analysis screens are very simple compared to the On-Page Analysis screens. There are 3
primary screens:
1. Link Finder – This view is accessed by entering one or more keywords into the Off-Page Search
Bar. This view displays the most important sources of Links for the given keywords. One of the
most important metrics, “Incremental Link Flow Share”, can be used to anticipate how much
Link Flow would flow through a new Link on that particular Webpage.
2. Link Explorer –This view is accessed by entering a URL into the Off-Page Search Bar. This view
displays the most important and relevant Incoming Links that are known for this URL. You can
click on the green dropdown arrows to view important statistics for each Link, as well as filter on
any Link characteristic. In addition, you can track any of these Links by checking the checkbox
next to the link and clicking on Track Links at the top of that column. These Links will be tracked
to for any future changes, good or bad.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
22
3. Link Tracker – Any Links that you have chosen to track on the Link Explorer will show up on your
Link Tracker screen, accessible from your Customer Home.
On this screen, you can compare current vs. previous versions of each Link. The most changed
Links will always appear at the top of your list – marked by the percentage change in value.
4. Neighborhood Explorer – This view shows the list of Link Neighborhoods and their top Market
Focuses. You can access this view by clicking on the “[switch]” link next to the current Link
Neighborhood. When you click on a Neighborhood, you will also see a list of the top Market
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
23
Focuses for each Neighborhood. Clicking on one of these Market Focuses will take you to a Link
Finder screen.
How to Use Market Brew API Web Services
Market Brew API, or “Application Programming Interface”, allows customers to develop their own
customized interface around Market Brew data. This API / Web Service is accessed through HTTP and
returns formatted XML according to Market Brew API XML Schema Definition.
Market Brew API XML Schema Definition
The public Market Brew API XML Schema Definition can always be accessed at the following location:
http://brew.marketbrew.com/api/schema.xsd
The XML schema definition file (.xsd) contains all of the information you need to parse responses
received from Market Brew API system. A small piece of the .xsd file is shown below. You can use any
language to consume and process these XML requests and responses. There are many SDKs that enable
you to easily and quickly work with this type of markup.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
24
Security/Authentication
To access the API, you must first assign at least one IP Address to your account. This is done on your
Customer Home  Edit Settings  Market Brew Settings Screen. Any API Requests from these IP
Addresses will then be associated with your account.
Market Brew API Requests
Request URLs
The table below illustrates the requests and the URL at which each request can be retrieved.
ON-PAGE API REQUESTS
API CALL
URL
WEBPAGE
https://brew.marketbrew.com/api/webpage.xml
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
25
CRAWL
https://brew.marketbrew.com/api/crawl.xml
CUSTOMER
https://brew.marketbrew.com/api/customer.xml
QUEUE
https://brew.marketbrew.com/api/queue.xml
QUOTE
https://brew.marketbrew.com/api/quote.xml
SITE MONITOR
https://brew.marketbrew.com/api/site-monitor.xml
MARKET FOCUS DATA
https://brew.marketbrew.com/api/market-focus.xml
DUPLICATE CONTENT
https://brew.marketbrew.com/api/correlation.xml
WEBSITE DATA
https://brew.marketbrew.com/api/website.xml
PRIVACY DATA
https://brew.marketbrew.com/api/privacy.xml
INDIVIDUAL LINK DATA https://brew.marketbrew.com/api/link.xml
ALERTS
https://brew.marketbrew.com/api/alerts.xml
LINK LISTING
https://brew.marketbrew.com/api/link-listing.xml
PAGE LISTING
https://brew.marketbrew.com/api/page-listing.xml
SEARCH LISTING
https://brew.marketbrew.com/api/search-listing.xml
ON-DEMAND CRAWL
https://brew.marketbrew.com/api/recrawl.xml
OFF-PAGE API REQUESTS
API CALL
URL
LINK NEIGHBORHOOD EXPLORER
https://brew.marketbrew.com/api/link-hood-explorer.xml
LINK NEIGHBORHOOD LISTING
https://brew.marketbrew.com/api/link-hood-listing.xml
Request Details
The table below illustrates the requests, their parameters, and their corresponding response types.
Refer to the XML Schema Definitions for the response type definitions. Note: required parameters are
in bold. Note: Responses may include redirects to the final XML response. Make sure your client
follows redirects.
ON-PAGE API REQUESTS
API CALL
PARAMETERS (caSe senSitiVe)
RESPONSE TYPE
WEBPAGE DATA
&host=<URL Host>
&path=<URL Path>
Webpage
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
26
CRAWL
&host=<URL Host>
&email=<email>
&callback=<Callback URL>
QueueStatus
CUSTOMER
<none>
Customer
QUEUE
&host=<URL Host>
&email=<email>
QueueStatus
QUOTE
&host=<URL Host>
Quote
MARKET FOCUS
DATA
DUPLICATE
CONTENT
&host=<URL Host>
&numPages=<# of scored pages>
&javascript=<0|1>
&resetPages=<0|1>
&days=<7|14|28>
&discount=<discount code>
&callback=<Callback URL>
&host=<URL Host>
&path=<URL Path>
&host=<URL Host>
&path=<URL Path>
WEBSITE DATA
&host=<URL Host>
SITE MONITOR
PRIVACY DATA
INDIVIDUAL LINK
DATA
ALERTS
LINK LISTING
PAGE LISTING
SEARCH LISTING
&host=<URL Host>
&path=<URL Path>
&host=<URL Host>
&path=<URL Path>
&webpageFrom=<URL>
&webpageTo=<URL>
&startPosition=<numeric>
&host=<URL Host>
&path=<URL Path>
&host=<URL Host>
&path=<URL Path>
&type=<see On-Page Link Listing Types, default “ao”>
&start=<numeric, default 1>
&num=<numeric, default 10, max 100>
&filter=<filter>
&filterType=<see On-Page Link Listing Filter Types>
&wholeWord=<0|1>
&exactMatch=<0|1>
&host=<URL Host>
&path=<URL Path>
&type=<see Page Listing Types, default “alp”>
&start=<numeric, default 1>
&num=<numeric, default 10, max 100>
&filter=<filter>
&filterType=<see Page Listing Filter Types>
&host=<URL Host>
PurchaseResult
MarketFocusResult
Correlations
Website
PrivacyInfo
Link
Alerts
OnPageLinkListing
PageListing
PageListing
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
27
&query=<query>
ON-DEMAND
CRAWL
&host=<URL Host>
&numPages=<# of scored pages>
&javascript=<0|1>
&resetPages=<0|1>
&discount=<discount code>
&callback=<Callback URL>
PurchaseResult
OFF-PAGE API REQUESTS
Notes: “auto” parameter for automatic lookup of appropriate Link Neighborhood. For Link
Explorer Requests, this causes a crawl on the specified URL to determine its Market Focus
(subsequent calls are cached / cache can be reset by setting auto=0).
1 Off-Page Request Credit = 10 results. Examples: &num=90 requires 9 credits. &num=91
requires 10 credits.
API CALL
LINK FINDER
(KEYWORD SEARCH)
LINK EXPLORER
(URL SEARCH)
LINK TRACKER
PARAMETERS (caSe senSitiVe)
&q=<Keywords>
&lh=<Link Neighborhood ID>
&start=<numeric, default 1>
&num=<numeric, default 10, max 100>
&lvl=<numeric, default 0>
&lvh=<numeric, default infinity>
&lvft=<see Off-Page Link Finder Filter Types>
&auto=<0|1, default 1>
&q=<URL>
&lh=<Link Neighborhood ID>
&start=<numeric, default 1>
&num=<numeric, default 10, max 100>
&filter=<filter>
&filterType=<see Off-Page Link Explorer Filter
Types>
&wholeWord=<0|1>
&exactMatch=<0|1>
&auto=<0|1, default 1>
&tls=<tracked link save ids, colon delimited>
&tlaid=<tracked link id>
&start=<numeric, default 1>
&num=<numeric, default 10, max 100>
&tld=<tracked link delete ids, colon delimited>
&tlaid=<tracked link id>
&tlad=<any value triggers tracked link account
deletion>
RESPONSE TYPE
OffPageLinkListing
OffPageLinkListing
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
28
LINK
NEIGHBORHOOD
LISTING
&lh=<Link Neighborhood ID>
LinkNeighborhoodListing
URL Encoding
Some of the requests include parameters that require URLs (host, webpageFrom, webpageTo, callback).
Please ensure that these values are properly encoded. For more information, please visit:
http://www.blooberry.com/indexdot/html/topics/urlencoding.htm.
Additional Callback URL
Some of the requests initiate processes that do not finish immediately, such as a Crawl, Site Monitor, or
On-Demand Crawl, and therefore include a “callback” parameter. This parameter allows you to include
a callback URL, in addition to your Default Callback URL in your Customer Home. If you do not specify a
callback parameter, your Default Callback URL defined in your Customer Home will be used, if set. Note:
Market Brew will NOT attempt to retry calling this URL in the event of a failure.
Listing Types
The following types are used on listing screens.
Link Listing Types
The following table illustrates the different types of Link Listings, and their corresponding codes. They
consist of “Base Types”, which are then optionally concatenated one or more “Modifier s”.
Base Types – These are always listed first.
Type
All Outgoing
External Outgoing
Internal Outgoing
All Incoming
External Incoming
Internal Incoming
Session ID
Non-Session ID
Cloaked
Non-Cloaked
Broken
Non-Broken
Dangling
Non-Dangling
Code (caSe senSitiVe)
ao
eo
io
ai
ei
ii
id
nid
cl
ncl
bk
nbk
dg
ndg
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
29
Followed
Nofollowed
Reciprocal
Non-Reciprocal
Reciprocal Site-Wide
Non-Reciprocal Site-Wide
Editorial
Non-Editoral
fol
nf
rc
nrc
swrc
swnrc
ed
ned
Modifiers – These are always concatenated together after the Base Types.
Type
With Session ID
Without Session ID
With Cloaked
Without Cloaked
With Broken
Without Broken
With Dangling
Without Dangling
With Nofollow
Without Nofollow
With Reciprocal
Without Reciprocal
With Reciprocal Site-Wide
Without Reciprocal Site-Wide
With Editorial
Without Editoral
Code (caSe senSitiVe)
wid
woid
wcl
wocl
wbk
wobk
wdg
wodg
wnf
wonf
wrc
worc
wswrc
woswnrc
wed
woed
Example 1: Concatenate “ao” (All Outgoing) with “wnf” (With No-Follow), to get All Outgoing Links with
a “nofollow” attribute. [&type=aownf]
Example 2: Concatenate “dg” (Dangling ) with “wnf” (With No-Follow) and “woed” (Without Editorial)
to get All Dangling Links with a “nofollow” attribute that are not Editorial. [&type=dgwnfwoed]
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
30
Page Listing Types
The following table illustrates the different types of Page Listings, and their corresponding codes. They
consist of “Base Types” only.
Base Types
Type
All Documents
All HTML Webpages
Missing META Title
Missing META Description
Duplicate META Title
Duplicate META Description
Duplicate Market Focus
Duplicate Spelling
Exact Duplicate Content
Irrelevant
Orphaned
Code (caSe senSitiVe)
ald
alp
mmt
mmd
dmt
dmd
dmf
dus
duce
irr
orp
Filter Types
The following types are used on listing screens to filter results even further.
On-Page Link Listing Filter Types
The following table illustrates the different types of filters that can be used on Link Listings, and their
corresponding codes.
On-Page Link Listing Filter Types
Type
Webpage From
Webpage To
Anchor Text
Code (caSe senSitiVe)
webpageFrom
webpageTo
anchortext
Page Listing Filter Types
The following table illustrates the different types of filters that can be used on Page Listings, and their
corresponding codes.
Page Listing Filter Types
Type
Title
Code (caSe senSitiVe)
title
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
31
Description
Market Focus
URL
desc
marketFocus
url
Off-Page Link Finder Filter Types
The following table illustrates the different types of filters that can be used on Link Neighborhood Finder
Listings, and their corresponding codes.
Off-Page Link Explorer Filter Types
Type
$ Link Value
Incremental Link Flow Share
Code (caSe senSitiVe)
linkvalue
incrementallinkflow
Off-Page Link Explorer Filter Types
The following table illustrates the different types of filters that can be used on Link Neighborhood
Explorer Listings, and their corresponding codes.
Off-Page Link Explorer Filter Types
Type
URL
Anchor Text
Code (caSe senSitiVe)
webpageFrom
anchortext
Pricing
All API Requests are charged on a per-call basis, and monthly usage fees are processed at the end of
each billing cycle. You may view a breakdown of your historical API Requests by viewing your API Usage
under the View Info tab on your Customer Home.
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
32
Testing
You may test the API system by utilizing the keyword “TESTDRIVE” for your <URL host> parameter.
Market Brew will NOT bill your account, enabling you to develop your application in the live
environment without worrying about charges.
API Sample Request/Responses
The following is a small sample of API calls, intended to give you an idea of the Request/Response
mechanism. Note: Developers should refer to the latest XML Schema Definition file for the most up to
date information.
Website
Request: /api/website.xml?host=www.trumbullnaturecenter.com
Response:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
33
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
34
Webpage
Request: /api/webpage.xml?host=www.trumbullnaturecenter.com&path=
Response:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
35
Market Focus
Request: /api/market-focus.xml?host=www.trumbullnaturecenter.com&path=
Response:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.
36
Correlation
Request: /api/webpage.xml?host=www.trumbullnaturecenter.com&path=
Response:
Copyright (C) 2006-2014 Market Brew™ and MarketBrew.com. All Rights Reserved. U.S. Patent No. 8,447,751. Additional Patents Pending.
Reproduction and/or distribution is strictly prohibited without the written consent of MarketBrew.com.