Skip to content
    Moz logo Menu open Menu close
    • Products
      • Moz Pro
      • Moz Pro Home
      • Moz Local
      • Moz Local Home
      • STAT
      • Moz API
      • Moz API Home
      • Compare SEO Products
      • Moz Data
    • Free SEO Tools
      • Domain Analysis
      • Keyword Explorer
      • Link Explorer
      • Competitive Research
      • MozBar
      • More Free SEO Tools
    • Learn SEO
      • Beginner's Guide to SEO
      • SEO Learning Center
      • Moz Academy
      • SEO Q&A
      • Webinars, Whitepapers, & Guides
    • Blog
    • Why Moz
      • Agency Solutions
      • Enterprise Solutions
      • Small Business Solutions
      • Case Studies
      • The Moz Story
      • New Releases
    • Log in
    • Log out
    • Products
      • Moz Pro

        Your all-in-one suite of SEO essentials.

      • Moz Local

        Raise your local SEO visibility with complete local SEO management.

      • STAT

        SERP tracking and analytics for enterprise SEO experts.

      • Moz API

        Power your SEO with our index of over 44 trillion links.

      • Compare SEO Products

        See which Moz SEO solution best meets your business needs.

      • Moz Data

        Power your SEO strategy & AI models with custom data solutions.

      NEW Keyword Suggestions by Topic
      Moz Pro

      NEW Keyword Suggestions by Topic

      Learn more
    • Free SEO Tools
      • Domain Analysis

        Get top competitive SEO metrics like DA, top pages and more.

      • Keyword Explorer

        Find traffic-driving keywords with our 1.25 billion+ keyword index.

      • Link Explorer

        Explore over 40 trillion links for powerful backlink data.

      • Competitive Research

        Uncover valuable insights on your organic search competitors.

      • MozBar

        See top SEO metrics for free as you browse the web.

      • More Free SEO Tools

        Explore all the free SEO tools Moz has to offer.

      What is your Brand Authority?
      Moz

      What is your Brand Authority?

      Check yours now
    • Learn SEO
      • Beginner's Guide to SEO

        The #1 most popular introduction to SEO, trusted by millions.

      • SEO Learning Center

        Broaden your knowledge with SEO resources for all skill levels.

      • On-Demand Webinars

        Learn modern SEO best practices from industry experts.

      • How-To Guides

        Step-by-step guides to search success from the authority on SEO.

      • Moz Academy

        Upskill and get certified with on-demand courses & certifications.

      • SEO Q&A

        Insights & discussions from an SEO community of 500,000+.

      Unlock flexible pricing & new endpoints
      Moz API

      Unlock flexible pricing & new endpoints

      Find your plan
    • Blog
    • Why Moz
      • Small Business Solutions

        Uncover insights to make smarter marketing decisions in less time.

      • Agency Solutions

        Earn & keep valuable clients with unparalleled data & insights.

      • Enterprise Solutions

        Gain a competitive edge in the ever-changing world of search.

      • The Moz Story

        Moz was the first & remains the most trusted SEO company.

      • Case Studies

        Explore how Moz drives ROI with a proven track record of success.

      • New Releases

        Get the scoop on the latest and greatest from Moz.

      Surface actionable competitive intel
      New Feature

      Surface actionable competitive intel

      Learn More
    • Log in
      • Moz Pro
      • Moz Local
      • Moz Local Dashboard
      • Moz API
      • Moz API Dashboard
      • Moz Academy
    • Avatar
      • Moz Home
      • Notifications
      • Account & Billing
      • Manage Users
      • Community Profile
      • My Q&A
      • My Videos
      • Log Out

    The Moz Q&A Forum

    • Forum
    • Questions
    • Users
    • Ask the Community

    Welcome to the Q&A Forum

    Browse the forum for helpful insights and fresh discussions about all things SEO.

    1. Home
    2. Moz Tools
    3. API
    4. How to get backlinks with the API

    Moz Q&A is closed.

    After more than 13 years, and tens of thousands of questions, Moz Q&A closed on 12th December 2024. Whilst we’re not completely removing the content - many posts will still be possible to view - we have locked both new posts and new replies. More details here.

    How to get backlinks with the API

    API
    3
    25
    8039
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as question
    Log in to reply
    This topic has been deleted. Only users with question management privileges can see it.
    • dinom
      dinom last edited by

      How do i use the MOZ API to get backlinks report?

      1 Reply Last reply Reply Quote 0
      • DavidLee
        DavidLee @silvacarl last edited by

        I'm afraid not for bash curls. We do share example code for calling our API using other languages at https://github.com/seomoz/SEOmozAPISamples

        1 Reply Last reply Reply Quote 0
        • silvacarl
          silvacarl @silvacarl last edited by

          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.

          DavidLee 1 Reply Last reply Reply Quote 0
          • DavidLee
            DavidLee @silvacarl last edited by

            Anytime!

            1 Reply Last reply Reply Quote 0
            • silvacarl
              silvacarl @DavidLee last edited by

              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

              silvacarl 1 Reply Last reply Reply Quote 0
              • silvacarl
                silvacarl @DavidLee last edited by

                got it!  really really appreciate your help!

                DavidLee 1 Reply Last reply Reply Quote 0
                • DavidLee
                  DavidLee @silvacarl last edited by

                  That URL is not an API call as it is a direct link to our online web app via web browser.

                  silvacarl 1 Reply Last reply Reply Quote 0
                  • silvacarl
                    silvacarl @DavidLee last edited by

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

                    DavidLee 1 Reply Last reply Reply Quote 0
                    • DavidLee
                      DavidLee @silvacarl last edited by

                      This will mean we have not discovered links from external sites to pages at those domains

                      https://moz.com/researchtools/ose/links?site=shantiquesparoom.com&filter=&source=external&target=domain&group=0&page=1&sort=page_authority&anchor_id=&anchor_type=&anchor_text=&from_site=

                      silvacarl 1 Reply Last reply Reply Quote 0
                      • DavidLee
                        DavidLee last edited by

                        You would only need to enter the domain in the search field on OSE to return metrics you can compare against API results.

                        OSE is our web app which calls our API.

                        silvacarl 1 Reply Last reply Reply Quote 0
                        • silvacarl
                          silvacarl @DavidLee last edited by

                          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?

                          1 Reply Last reply Reply Quote 0
                          • silvacarl
                            silvacarl @DavidLee last edited by

                            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?

                            DavidLee 1 Reply Last reply Reply Quote 0
                            • DavidLee
                              DavidLee @silvacarl last edited by

                              Hi Carl

                              The call is malformed with an additional scope parameter: http://www.screencast.com/t/zTqfBb0NuAO

                              If you remove the extra &Scope=

                              The call should work

                              silvacarl 1 Reply Last reply Reply Quote 0
                              • silvacarl
                                silvacarl @DavidLee last edited by

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

                                DavidLee 1 Reply Last reply Reply Quote 0
                                • DavidLee
                                  DavidLee @silvacarl last edited by

                                  Can you paste the full URL call your app generated minus credentials so I can take a look?

                                  silvacarl 1 Reply Last reply Reply Quote 0
                                  • silvacarl
                                    silvacarl @DavidLee last edited by

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

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

                                    DavidLee 1 Reply Last reply Reply Quote 0
                                    • DavidLee
                                      DavidLee last edited by

                                      Also to test your results, you can cross-reference by filtering page/sub-domain/root-domain directly on OSE https://moz.com/researchtools/ose/links?site=10.billing.callmydoc.com&filter=&source=external&target=domain&group=0&page=1&sort=page_authority&anchor_id=&anchor_type=&anchor_text=&from_site=

                                      silvacarl 1 Reply Last reply Reply Quote 0
                                      • DavidLee
                                        DavidLee last edited by

                                        You would only need to adjust the scope to be &Scope=page_to_subdomain

                                        as the above example would only give you results to any page at callmydoc.com

                                        silvacarl 1 Reply Last reply Reply Quote 0
                                        • silvacarl
                                          silvacarl @DavidLee last edited by

                                          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-)

                                          1 Reply Last reply Reply Quote 0
                                          • DavidLee
                                            DavidLee last edited by

                                            Hey Carl!

                                            We do provide examples in the documentation. They can be filtered in many ways.

                                            Here is a very basic call that will return the first 25 links to all pages going to moz.com which will provide the linking page and the page being link to

                                            http://lsapi.seomoz.com/linkscape/links/moz.com?AccessID=member-xxxxxxxx&Expires=xxxxxxxx&Signature=xxxxxxxx&Scope=page_to_domain&Filter=external&Sort=page_authority&SourceCols=4&TargetCols=4&LinkCols=4&Limit=25

                                            The first result will look like this:

                                            [0] => Array
                                            (
                                            [lrid] => 460538186303
                                            [lsrc] => 131443324666
                                            [lt] => "Google Algorithm Change History"
                                            [ltgt] => 68767261786
                                            [luuu] => moz.com/google-algorithm-change
                                            [uu] => en.wikipedia.org/wiki/Google_Panda

                                            Hope this helps!

                                            silvacarl 1 Reply Last reply Reply Quote 0
                                            • silvacarl
                                              silvacarl @silvacarl last edited by

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

                                              1 Reply Last reply Reply Quote 0
                                              • silvacarl
                                                silvacarl @DavidLee last edited by

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

                                                silvacarl 1 Reply Last reply Reply Quote 0
                                                • DavidLee
                                                  DavidLee last edited by

                                                  Hi Dinom

                                                  Keep in mind this is not a number of ALL of your backlinks as our tool is not a complete index of all of your links. Our link discovery methods are based on Domain Authority to only show you quality links to a domain. There isn't a single call to fetch all of the links as there is a limit of 25 rows of data you can return for each call and there is a rate limit.

                                                  The options you have can be found here:

                                                  http://apiwiki.moz.com/link-metrics

                                                  silvacarl 1 Reply Last reply Reply Quote 0
                                                  • dinom
                                                    dinom last edited by

                                                    Hi David,

                                                    What i want is to use the API to give me the list of backlinks for my website. Something like the webapp u already have. But i want to know the API call which can be used to achieve that. The link you gave...that can only be used to find out the number of links (all including backlink, external, no follow foloow etc)..what i am requesting is that is there a API call which would list down the backlink urls for me?

                                                    1 Reply Last reply Reply Quote 0
                                                    • DavidLee
                                                      DavidLee last edited by

                                                      Hi Dino

                                                      URL-Metrics for the API can be found here: http://apiwiki.moz.com/url-metrics

                                                      Hope this helps

                                                      1 Reply Last reply Reply Quote 0
                                                      • 1 / 1
                                                      • First post
                                                        Last post

                                                      Got a burning SEO question?

                                                      Subscribe to Moz Pro to gain full access to Q&A, answer questions, and ask your own.


                                                      Start my free trial


                                                      Browse Questions

                                                      Explore more categories

                                                      • Moz Tools

                                                        Chat with the community about the Moz tools.

                                                      • SEO Tactics

                                                        Discuss the SEO process with fellow marketers

                                                      • Community

                                                        Discuss industry events, jobs, and news!

                                                      • Digital Marketing

                                                        Chat about tactics outside of SEO

                                                      • Research & Trends

                                                        Dive into research and trends in the search industry.

                                                      • Support

                                                        Connect on product support and feature requests.

                                                      • See all categories

                                                      Related Questions

                                                      • Skys

                                                        Unsolved MOZ API for domain authority

                                                        api da

                                                        I am using the MOZ API to check domain authority (DA). Recently, I noticed a discrepancy: the DA value retrieved via the API differs from the result on the MOZ homepage. Specifically, the API returns a DA of 10, while the homepage shows "NO DATA." Additionally, other services like Ahrefs report a DA of 0. I relied on the MOZ API's result when purchasing this domain and now feel misled. I would like to understand the exact reason for this inconsistency.

                                                        API | | Skys
                                                        0
                                                      • adrianTNT

                                                        Unsolved How to get Domain Authority using API ?

                                                        api domain authority

                                                        I wanted to test the API and while looking on the documentation urls, I cannot find details on how to get Domain Authority. is that not available to query ? was it replaced by Brand Authority ? is it only available for the paid API or for the free one too ? I looked at many documentation pages but I find it very confusing and frustrating, there are many versions of the documentation and various URLs and not clearly labeled, I understand some are V1, V2, V3, etc, but I didn't find sample API calls for Domain Authority. Thank you.

                                                        API | | adrianTNT
                                                        0
                                                      • NickAndrews

                                                        Unsolved Regarding Moz API token password update

                                                        moz api access token

                                                        Hi, In March we have updated password for MOZ API and used in our application it worked, but currently the updated password is not working and in the MOZ site the old password is shown and its active. We are using Legacy username and password.
                                                        We see that 5 tokens can be added for API, if we add 2 tokens both will be active.
                                                        We are currently using free services. Please help us resolve this issue.

                                                        API | | NickAndrews
                                                        0
                                                      • OlegShavilov

                                                        Unsolved Generate an Access ID and API key

                                                        api

                                                        Hello, I can't generate an Access ID and API key for my account.
                                                        I need a Links API and I'm ready to buy a paid subscription, but I can't do it. Link https://moz.com/products/mozscape/access
                                                        Redirected to https://moz.com/api/dashboard And i dont see any options for create Access ID

                                                        API | | OlegShavilov
                                                        0
                                                      • Dima124dsfg

                                                        Unsolved Api limits on free plan

                                                        api

                                                        Good afternoon. I tried connecting free access to api https://moz.com/help/links-api/v1-archive/v1-free-api-access to retrieve DA data. After several requests to the api I got a message: "Your monthly row limit reached" Can you tell me what this error is related to? Or Moz doesn't have free api access anymore?

                                                        API | | Dima124dsfg
                                                        1
                                                      • CarolinaRen

                                                        Unsolved Can I get Moz keywords via API?

                                                        api keywords

                                                        Hi, my boss is asking if you "have any API for keyword research -- e.g., as soon as a user creates a card title in [our application], we can auto-recommend keywords from Moz within [the application]. I shared a link with him to your Links API page, but he says he doesn't think that API does the above. Can you help? Thank you, Renae

                                                        API | | CarolinaRen
                                                        0
                                                      • MattHopkins

                                                        API - Row Limit Question

                                                        Hi, I'm new to using Moz, and have just got a "Low volume" API account set up. My question is, because ive not yet reached my maximum "Rows per month" limit, what behaviour happens when i reach it? Do i get an error code, if so what, and whats the status code. If not, does my account keep downloading the rows and i get charged extra (in accordance with the cost of the additional rows)? Or is the whole additional rows think like a bolt on? Basically i want to make sure i dont get charged extra each month, and i need the status code returned to handled this in my app. I couldnt see anything explicit in the documents. Cheers

                                                        API | | MattHopkins
                                                        0
                                                      • eBrandz

                                                        Seo moz api request problem [401 error_message Your authentication failed]

                                                        Hello Team, I have moz pro account. I'm getting following error for seomoz call using your API: {"status":"401","error_message":"Your authentication failed. Check your authentication details and try again. For more information on signed authentication, see: http://apiwiki.moz.com/signed-authentication"} The link that we are using is:
                                                            http://lsapi.seomoz.com/linkscape/url-metrics/ And following bits are requested during the call: 68719476736 34359738368 32 2048 16384 The error is intermittent. It comes and goes. There were no issues with results 3 days ago. I suddenly started getting this error. Could you please investigate into it and let me know the cause of issues and its correctiveness. It will great if you can provide us a support email Id for immediate response. Thanks,

                                                        API | | eBrandz
                                                        0

                                                      Get started with Moz Pro!

                                                      Unlock the power of advanced SEO tools and data-driven insights.

                                                      Start my free trial
                                                      Products
                                                      • Moz Pro
                                                      • Moz Local
                                                      • Moz API
                                                      • Moz Data
                                                      • STAT
                                                      • Product Updates
                                                      Moz Solutions
                                                      • SMB Solutions
                                                      • Agency Solutions
                                                      • Enterprise Solutions
                                                      Free SEO Tools
                                                      • Domain Authority Checker
                                                      • Link Explorer
                                                      • Keyword Explorer
                                                      • Competitive Research
                                                      • Brand Authority Checker
                                                      • MozBar Extension
                                                      • MozCast
                                                      Resources
                                                      • Blog
                                                      • SEO Learning Center
                                                      • Help Hub
                                                      • Beginner's Guide to SEO
                                                      • How-to Guides
                                                      • Moz Academy
                                                      • API Docs
                                                      About Moz
                                                      • About
                                                      • Team
                                                      • Careers
                                                      • Contact
                                                      Why Moz
                                                      • Case Studies
                                                      • Testimonials
                                                      Get Involved
                                                      • Become an Affiliate
                                                      • MozCon
                                                      • Webinars
                                                      • Practical Marketer Series
                                                      • MozPod
                                                      Connect with us

                                                      Contact the Help team

                                                      Join our newsletter
                                                      Moz logo
                                                      © 2021 - 2025 SEOMoz, Inc., a Ziff Davis company. All rights reserved. Moz is a registered trademark of SEOMoz, Inc.
                                                      • Accessibility
                                                      • Terms of Use
                                                      • Privacy

                                                      Looks like your connection to Moz was lost, please wait while we try to reconnect.