curl -X GET 'https://api.parse.bot/scraper/40c93e64-04b1-40b9-b5cc-b53c7c4574bb/get_smart_link?url=https%3A%2F%2Flnk.to%2Ffolklore' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches one Linkfire smart link landing page and returns its campaign information in a single round trip. The result is one object for the link: the page title and subtitle as displayed, artist, release title (album or track when the campaign has catalog metadata; null on pre-release pages that have not been attached to a catalog item yet), cover artwork URL, label, UPC/ISRC identifiers when published, the owning label/board, and the ordered `services` list — one entry per button on the page with the service name, the button action (e.g. Play, Download, Pre-save, Pre-add, Join), its action type, rank and the destination URL the button points to (null for buttons that are driven by an in-page connect flow, such as Apple Music pre-add, or an email sign-up). `is_presave` is true when at least one service is a pre-save/pre-add destination; `link_type` is the site's own link class (PreRelease, Music, Content, ...). `release_date` is only populated when the page publishes an explicit release date; on every page observed during the build the site did not publish one, so expect null in most cases. Content-type links that simply redirect to an external page return a single service entry with that external destination. A URL that Linkfire does not know returns a not-found input error.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | The Linkfire smart link URL, either https://lnk.to/<slug> or https://<artist>.lnk.to/<slug>. The scheme may be omitted. Other hosts are rejected. |
{
"type": "object",
"fields": {
"url": "canonical smart link URL as reported by the page",
"upcs": "array of UPC strings (may be empty)",
"album": "album title or null",
"board": "name of the Linkfire board (label/artist team) that owns the link",
"isrcs": "array of ISRC strings (may be empty)",
"label": "label / copyright line or null",
"title": "headline shown on the landing page",
"track": "track title or null",
"artist": "artist name, or null when the page does not publish one",
"link_id": "Linkfire's identifier for this smart link",
"services": "ordered array of destination buttons: service_id, service_name, action, action_type, rank, is_presave, destination_url",
"subtitle": "secondary line shown under the headline (artist name, 'Choose music service', 'Out now.', ...)",
"link_type": "Linkfire link class: PreRelease, Music, Content, ...",
"is_presave": "true when any service entry is a pre-save/pre-add destination",
"artwork_url": "cover art image URL (square) or null",
"description": "page meta description",
"organisation": "owning organisation as published by the page or null",
"release_date": "ISO-8601 release date when the page publishes one, otherwise null",
"release_title": "album title, falling back to the track title; null when the campaign has no catalog metadata",
"share_image_url": "social-share image URL or null",
"organisation_group": "parent organisation group or null"
},
"sample": {
"data": {
"url": "https://averyanna.lnk.to/presave",
"upcs": [],
"album": null,
"board": "Avery Anna",
"isrcs": [],
"label": null,
"title": "Pre-save/pre-add new music",
"track": null,
"artist": "Avery Anna",
"link_id": "296d1fbd-1a15-465a-bb18-1c86e6f0dbbd",
"services": [
{
"rank": 1,
"action": "Pre-add",
"is_presave": true,
"service_id": "08d8cfe0-eebc-4505-b7db-c457480d4c9c",
"action_type": "prerelease",
"service_name": "AppleMusicPreRelease",
"destination_url": null
},
{
"rank": 2,
"action": "Pre-save",
"is_presave": true,
"service_id": "f0eb9655-b1de-49a6-b88d-7fe4ae11aa55",
"action_type": "prerelease",
"service_name": "SpotifyPreRelease",
"destination_url": "https://accounts.spotify.com/authorize?response_type=code&client_id=<client_id>&redirect_uri=https%3A%2F%2Flnk.to%2F~%2Fprerelease%2Fspotify&state=<state>"
},
{
"rank": 4,
"action": "Join",
"is_presave": false,
"service_id": "f50735c5-cab4-444f-8e71-42dbea3163e8",
"action_type": "join",
"service_name": "emailsignup",
"destination_url": null
}
],
"subtitle": "Avery Anna",
"link_type": "PreRelease",
"is_presave": true,
"artwork_url": "https://linkstorage.linkfire.com/medialinks/images/8589b5e3-4b4c-45a9-a24f-31e0e051e852/artwork-440x440.jpg",
"description": "Listen to content by Avery Anna.",
"organisation": "Warner Records Nashville",
"release_date": null,
"release_title": null,
"share_image_url": "https://linkstorage.linkfire.com/medialinks/images/8c0a8c05-01f2-4e1e-91f9-883161c143c5/artwork-600x315.jpg",
"organisation_group": "Warner Music Group"
},
"status": "success"
}
}About the Linkfire API
The Linkfire API on Parse exposes 1 endpoint for the publicly available data on linkfire.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.