GetNewLostBackLinks

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

This function returns new and lost backlinks in a date range

Resource Description

AnalysisResUnits

500

RetrievalResUnits

This resource will be decreased by actual number of rows of data retrieved (returned) by this function.

This function accepts the following parameters:

Parameter Description

cmd

Required: must be set to: GetNewLostBackLinks

datasource

Optional - defaults to historic
Either: "fresh" - to query against fresh index, or "historic" - to query against historic index.

item

Usual URL, domain or subdomain

Count

Number of results to be returned back.

Default: 100

Mode

Default is 0 showing new links

If set to 1 it will show lost links

Datefrom and Dateto

For ranged queries, accepts dates in format: YYYY-MM-DD as used in calender.

If dateform is not provided it will assume the most recent backlink date in index and will default to 1 day range.

NOTE: It's entirely possible thare are no new/lost links on that day.

Example:
http://api.majestic.com/api/xml?app_api_key=API_KEY&cmd=GetNewLostBackLinks&item=majestic.com&Count=10&datasource=fresh

This query in the Fresh Index produces the following XML:



Example:
http://api.majestic.com/api/json?app_api_key=API_KEY&cmd=GetNewLostBackLinks&item=majestic.com&Count=10&datasource=fresh

This query in the Fresh Index produces the following JSON:

Column Names

  1. ACRank: deprecated metric replaced with Trust and Citation Flow
  2. AnchorText: anchor text of lost link
  3. Date: date link was last encountered
  4. FlagRedirect: value of 1 indicates a redirect link
  5. FlagFrame: value of 1 indicates a link in an iframe
  6. FlagNoFollow: value of 1 indicates a nofollow link
  7. FlagImages: value of 1 indicates an image link
  8. FlagDeleted: value of 1 indicates a deleted link
  9. FlagAltText: value of 1 indicates a link with alt text
  10. FlagMention: value of 1 indicates a mention
  11. TargetURL: the URL the link had been pointed at
  12. DomainID: marks option to order by domain
  13. FirstIndexedDate: date this link was first discovered within queried index
  14. LastSeenDate: date this link was last seen within queried index
  15. DateLost: date link was lost
  16. ReasonLost: reason link was lost, when available
  17. LinkType: the type of link
  18. LinkSubType: more specific information on the type of link
  19. TargetCitationFlow: the Citation Flow of the target URL
  20. TargetTrustFlow: the Trust Flow of the target URL
  21. TargetTopicalTrustFlow_Topic_0: the most significant Topical Trust Flow category for the target URL (currently only available in the Fresh Index)
  22. TargetTopicalTrustFlow_Value_0: the value of the listed Topical Trust Flow category for the target URL(currently only available in the Fresh Index)
  23. SourceCitationFlow: the Citation Flow of the source URL
  24. SourceTrustFlow: the Trust Flow of the source URL
  25. SourceTopicalTrustFlow_Topic_0: the most significant Topical Trust Flow category for the source URL (currently only available in the Fresh Index)
  26. SourceTopicalTrustFlow_Value_0: the value of the listed Topical Trust Flow category for the source URL(currently only available in the Fresh Index)

For more information about access to the Majestic API suite, visit our Plans & Pricing page.