Root domains linking to the page

[PS Direct]

I am looking to obtain the count of "Root domains linking to the page"
via the API (i.e. the same one listed on the web page
http://www.seomoz.org/linkscape/intel/basic/?uri=www.bbc.co.uk )
however am having some difficulty working out how to do this.

As far as I can gather there are two main ways: counts available from
the fid, pid, uifq, uipl parameters or by returning all the links with
"domain_to_page" and manually counting them to get the total.

Can anyone clarify which parameter (fid, pid, uifq, uipl) would
provide the same count as "Root domains linking to the page, and how I
would go about using it. I tried using the "Scope" parameter however
it resulted in the message "unauthorized api".

Thank You

[Nick Gerner]

If you just want the count, you should use the url-metrics call and
get the uipl field. This is the count of distinct root domains
linking to the page in question.

Getting links would be both impractical (since this would get a huge
amount of data, and take much longer than necessary), and also the
links API will stop returning links after about 100k.

The unauthorized API error you're getting is probably related to the
issue described in this thread:
http://groups.google.com/group/seomoz-api/browse_thread/thread/11f232cb0b2cf1f6/28acdf7c08e3ff6f?lnk=gst&q=unauthorized#28acdf7c08e3ff6f

I hope that helps!

[PS Direct]

Thank you for the reply.

I notice that the "uipl" parameter does not seem to be returned on a
standard call to url-metrics e.g.

$urlToFetch = "http://lsapi.seomoz.com/linkscape/url-
metrics/".urlencode($objectURL)."?AccessID=".$accessID."&Expires=".
$expires."&Signature=".$urlSafeSignature;

Am I therefore correct in thinking this particular parameter is a
feature of the paid API only?

Or do I need to specify the "Cols" variable with one of the bit values
in order to obtain "uipl"? I tried a few of the obvious ones without
any luck, however looking at the documentation is is not immediately
obvious which bit value in the "URL Metric Bit Flags" section relate
to which result value in the "URL Metric Fields" section i.e. URL (but
value 4) I am guessing is "ufq" but I do not see any documentation
detailing this relationship.

I have seen the page at http://apiwiki.seomoz.org/SEOmoz-Free-API
which mentions "The total number of links" is available in the free
API however it is not entirely clear which total links it is referring
to "feid", "fid", "peid" etc, are all link counts, therefore are they
all available in the free API along with "uipl"?

Can you clarify?

Thank You

On Apr 5, 10:37 pm, Nick Gerner <n...@seomoz.org> wrote:
> If you just want the count, you should use the url-metrics call and
> get the uipl field.  This is the count of distinct root domains
> linking to the page in question.
>
> Getting links would be both impractical (since this would get a huge
> amount of data, and take much longer than necessary), and also the
> links API will stop returning links after about 100k.
>
> The unauthorized API error you're getting is probably related to the

> issue described in this thread:http://groups.google.com/group/seomoz-api/browse_thread/thread/11f232...

[Nick Gerner]

You are correct that uipl (the number of distinct root domains with at
least one link to the page in question, or "Root Domains Linking") is
not included in the free API.

Only uid is included in the free API which is the total number of
links. We don't provide the more specific counts about follows vs
nofollows, etc. in the free API.

Does that clarify things?

--Nick

On Apr 6, 7:54 am, PS Direct <psdirect...@googlemail.com> wrote:
> Thank you for the reply.
>
> I notice that the "uipl" parameter does not seem to be returned on a
> standard call to url-metrics e.g.
>
> $urlToFetch = "http://lsapi.seomoz.com/linkscape/url-
> metrics/".urlencode($objectURL)."?AccessID=".$accessID."&Expires=".
> $expires."&Signature=".$urlSafeSignature;
>
> Am I therefore correct in thinking this particular parameter is a
> feature of the paid API only?
>
> Or do I need to specify the "Cols" variable with one of the bit values
> in order to obtain "uipl"?  I tried a few of the obvious ones without
> any luck, however looking at the documentation is is not immediately
> obvious which bit value in the "URL Metric Bit Flags" section relate
> to which result value in the "URL Metric Fields" section i.e. URL (but
> value 4) I am guessing is "ufq" but I do not see any documentation
> detailing this relationship.
>

> I have seen the page athttp://apiwiki.seomoz.org/SEOmoz-Free-API

[PS Direct]

Ok many thanks.