Can you think of any other method for doing the subdomain backlink search?  I posted the code above if you want to play with it.

Or for that matter anyone can try it out.

see below curl bash examples for Moz API:

#!/bin/bash

Usage: ./moz-test.sh callmydoc.com or ./moz-test.sh solimancare.schedulemypatient.com

Note: backlinks for subdomains does not return results yet.

access_id="mozscape-xx"
secret_key="xx"

searchurl=$1
echo "Checking backlinks for ["$searchurl"]"
endpoint="lsapi.seomoz.com"

timenow=$(date +%s)
timeend=$(( ${timenow} + (606024) ))
stringToSign=${access_id}$'\n'${timeend}
signature=$(echo -n "${stringToSign}" | openssl dgst -sha1 -hmac "${secret_key}" -binary | base64)
signature=$(echo ${signature} | sed 's/+/%2B/g;s/=/%3D/g')

start=0
end=300
echo "Checking for practices from $start to $end"
rm found_urls.txt
touch found_urls.txt
for (( i=$start; i<$end; i++ )); do
numberofdots=$(echo $searchurl | grep -o "." | wc -l)
echo "number of dots ["$numberofdots"]"
if [ "$numberofdots" == "1" ]; then
url="http://lsapi.seomoz.com/linkscape/links/$searchurl?AccessID=${access_id}&Expires=${timeend}&Signature=${signature}&Scope=page_to_domain&Filter=external&Sort=page_authority&SourceCols=4&TargetCols=4&LinkCols=4&Limit=25"

url2="http://lsapi.seomoz.com/linkscape/url-metrics/$searchurl?Cols=4&AccessID=${access_id}&Expires=${timeend}&Signature=${signature}"
echo "Calling Moz url-metrics API with ["$url2"]"
curl $url
echo
read -n 1 -p "Press any key to continue . . ."
echo
else
url="http://lsapi.seomoz.com/linkscape/links/$searchurl?AccessID=${access_id}&Expires=${timeend}&Signature=${signature}&Scope=page_to_subdomain&Filter=external&Sort=page_authority&SourceCols=4&TargetCols=4&LinkCols=4&Limit=25"
fi
echo "Calling Moz API with ["$url"]"
curl $url > backlink-results.json
echo
jq -r '.[].uu' < backlink-results.json >> found_urls.txt
read -n 1 -p "Press any key to continue . . ."
echo

sleep a random amount between 1 and 30 seconds to not crush moz API

sleep $[ ( $RANDOM % 50 ) + 1 ]s
(( i + 50 ))
done

got it!  really really appreciate your help!

so the call would be like: url="https://moz.com/researchtools/ose/links?site=$searchurl?AccessID=${access_id}&Expires=${timeend}&Signature=${signature}"?

so I would take the json returned from the http://lsapi.seomoz.com/linkscape/links call and feed it back into this to cross reference, corect?

jeez.  8-(  Ok, got it.  wow, sorry.  fixed.  Now: http://lsapi.seomoz.com/linkscape/links/solimancare.schedulemypatient.com?AccessID=mozscape-xx&Expires=xx&Signature=xx%3D&Scope=page_to_subdomain&Filter=external&Sort=page_authority&SourceCols=4&TargetCols=4&LinkCols=4&Limit=50&Offset=0

does not return anything, just [].  It should show at least one of cal.callmydoc.com, solimancare.com, shantiquesparoom.com

should I tune up the parameters to be more specific?

this is for my wife's practice: http://lsapi.seomoz.com/linkscape/links/solimancare.schedulemypatient.com?AccessID=mozscape-xx&Expires=xx&Signature=xx%3D&Scope=&Scope=page_to_subdomain&Filter=external&Sort=page_authority&SourceCols=4&TargetCols=4&LinkCols=4&Limit=50&Offset=0

returns:

{
"status" : "403",
"error_message" : "Permission denied: naieofimocidphjeoaifmdkkmllomolnnf"
}

all i did was change that one parameter but now i am getting:

{
"status" : "403",
"error_message" : "Permission denied: blepcoehcjeidmfpcleoaigbaahfafhgbo"
}

THIS IS AWESOME!  If i am checking a subdomain, like 10.billing.callmydoc.com, do I need to do something different?

As usual, I will repost my findings once completed.  8-)

in other words, does someone have an example of the API parameters for the backlink API call?

can someone give us one example of getting all of the backlinks for our web site via API?

what is the specific API call to show backlinks on my URL?

However, what is the API call for getting backlinks?

sweet!  thanks!  it works!  here is my example for anyone else:

#!/bin/bash
access_id="xxxxxxx"

secret_key="xxxxxxxxxxxxxx"

The number of external links to the URL, including nofollowed links

External links: 549755813888 ued

The number of external links to the subdomain, including nofollowed links

External links to subdomain: 140737488355328 fed

The number of external links to the root domain, including nofollowed links

External links to root domain: 2251799813685248 ped

searchurl=$1
echo "Checking backlinks for ["$searchurl"]"
endpoint="lsapi.seomoz.com"

call="/url-metrics/${searchurl}%2fCols=1073741825"

call="/url-metrics/${searchurl}%2fCols=549755813888"

timenow=$(date +%s)
timeend=$(( ${timenow} + (606024) ))
stringToSign=${access_id}$'\n'${timeend}
signature=$(echo -n "${stringToSign}" | openssl dgst -sha1 -hmac "${secret_key}" -binary | base64)
signature=$(echo ${signature} | sed 's/+/%2B/g;s/=/%3D/g')

http://lsapi.seomoz.com/linkscape/url-metrics/moz.com%2Fblog?Cols=4&AccessID=member-cf180f7081&Expires=1225138899&Signature=LmXYcPqc%2BkapNKzHzYz2BI4SXfC%3D

http://lsapi.seomoz.com/linkscape/url-metrics/moz.com%2FCols=1073741825?AccessID=mozscape-9d88c16268&Expires=1476310241&Signature=Nuy5h4bV5Gkyw5s2X09E9WJ3sGQ%3D

for i in {1..250}; do
curl "http://lsapi1.seomoz.com/linkscape/links/10.portal.athenahealth.com?Filter=external&SourceCols=133982846973&TargetCols=133982846973&Sort=page_authority&AccessID=${access_id}&Expires=${timeend}&Signature=${signature}&Scope=page_to_domain&Limit=5&Offset=$((i100))&"
done

| tr "}" "n" | perl -pe "s/[][]//g" | perl -pe "s/,{//g" | perl -pe "s/"[^"]"://g" | perl -pe "s/^{//g" >> output.csv

url="http://$endpoint/linkscape$call?AccessID=${access_id}&Expires=${timeend}&Signature=${signature}"
echo "Calling Moz API with ["$url"]"
curl $url
echo

Which is the best API call to return external backlinks for a URL?

Does anyone have an example of using the Moz API with curl in bash?