curl -X GET 'https://api.parse.bot/scraper/9a23c720-3ba2-4170-925a-d56ec1db8904/get_smart_link?url=https%3A%2F%2Fexpertsonly.lnk.to%2Ffreak' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the release shown on a Linkfire smart link page (title, subtitle, description, artwork, artist/album name when the page carries them, release date when published) together with the ordered list of service buttons in the page's display order. Each service entry carries the button label, action text (e.g. Play, Pre-save, Shop), the button category type and the outbound URL. For released tracks the URL is the store/streaming destination; for unreleased pre-save campaigns it is the service's authorization link, and Apple Music pre-add buttons (handled in-page by Apple's client) have url null. One round trip per call. A URL that Linkfire does not know returns a stale_input/input_not_found error.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | Full Linkfire smart link URL of the form https://<board>.lnk.to/<slug> (the scheme may be omitted). Only lnk.to hosts are accepted. |
{
"type": "object",
"fields": {
"url": "normalized smart link URL that was fetched",
"title": "release title as displayed in the page header",
"link_id": "Linkfire's internal id for this smart link",
"services": "array of service buttons in display order: service_id, label, name, action, category, category_type, rank, url, logo_url",
"subtitle": "text under the title (e.g. 'Choose music service')",
"album_name": "album name from the page's embedded metadata; null when the page does not carry it",
"artist_name": "artist name from the page's embedded metadata; null when the page does not carry it",
"artwork_url": "square cover artwork image URL",
"description": "meta description of the page",
"og_image_url": "social share (Open Graph) image URL",
"release_date": "ISO 8601 release timestamp when Linkfire publishes one; null for unannounced pre-releases",
"service_count": "number of service buttons"
},
"sample": {
"data": {
"url": "https://expertsonly.lnk.to/freak",
"title": "Mesto, Ink - Freak",
"link_id": "10e422f2-642d-4667-9d1a-e8b15ef7d95f",
"services": [
{
"url": "https://accounts.spotify.com/authorize?response_type=code&client_id=<client>&redirect_uri=https%3A%2F%2Flnk.to%2F~%2Fprerelease%2Fspotify&state=<state>",
"name": "Spotify Pre-save",
"rank": 2,
"label": "SpotifyPreRelease",
"action": "Pre-save",
"category": "service",
"logo_url": "https://services.linkfire.com/notifications/logo_spotifyprerelease_onlight.svg",
"service_id": "f0eb9655-b1de-49a6-b88d-7fe4ae11aa55",
"category_type": "prerelease"
}
],
"subtitle": "Choose music service",
"album_name": null,
"artist_name": null,
"artwork_url": "https://linkstorage.linkfire.com/medialinks/images/c5403111-affa-4ccf-92ee-ae2afe9ddaa6/artwork-440x440.jpg",
"description": "Listen to content by Experts Only.",
"og_image_url": "https://linkstorage.linkfire.com/medialinks/images/c5403111-affa-4ccf-92ee-ae2afe9ddaa6/artwork-600x315.jpg",
"release_date": null,
"service_count": 6
},
"status": "success"
}
}About the Lnk API
The Lnk API on Parse exposes 1 endpoint for the publicly available data on expertsonly.lnk.to. 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.