{ "openapi": "3.0.3", "info": { "title": "Purfled Data API", "version": "1.1.0", "description": "Live public data from Google Maps, YouTube, TikTok, Amazon, LinkedIn, Airbnb, Telegram, Google News, Substack, the App Store, Google Play, Wikipedia and company websites, as JSON. One GET (or POST with a JSON body) per request.\n\nEvery success has the same shape: {tool, count, tookMs, runsOn, items, notices?}. Every error is JSON: {error}.\nData is fetched at request time. Most calls take 1-40 seconds; set your client timeout to at least 60 seconds.\nLimits that are too high are capped rather than rejected, and the response says so in notices, for example: [\"Ignored unknown parameter limit: not supported by tiktok-profiles. Supported: usernames\"].\nOnly public pages are used; no logins.\nEvery endpoint also accepts POST with the same parameters as a JSON body." }, "servers": [ { "url": "https://purfled.com" } ], "tags": [ { "name": "Leads" }, { "name": "YouTube" }, { "name": "Social" }, { "name": "E-commerce" }, { "name": "Jobs" }, { "name": "Travel" }, { "name": "News" }, { "name": "Apps" }, { "name": "Reference" }, { "name": "Meta" } ], "paths": { "/v1/google-maps": { "get": { "tags": [ "Leads" ], "summary": "Google Maps places search", "description": "Businesses from a Google Maps search: name, category, address, phone, website, rating, review count, opening hours and coordinates. With contacts=true it also visits each business website for emails and social profiles. The captured example took 3.7 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/google_maps_item" } } } } ] }, "example": { "tool": "google-maps", "count": 3, "tookMs": 3693, "runsOn": "apify", "items": [ { "searchQuery": "dentists in Leeds", "rank": 1, "name": "Leeds City Dentalcare", "categories": [ "Dentist", "Cosmetic dentist", "Dental hygienist" ], "category": "Dentist", "address": "159 Beeston Rd, Leeds LS11 6AW, United Kingdom", "street": "159 Beeston Rd", "city": "Leeds", "postalCode": "LS11 6AW", "state": null, "locality": "Leeds LS11 6AW", "cityLine": "Leeds LS11 6AW", "neighborhood": null, "country": "United Kingdom", "countryCode": "GB", "latitude": 53.778403399999995, "longitude": -1.5529913, "phone": "0113 270 5020", "phoneInternational": "+441132705020", "website": "https://www.leedscitydentalcare.co.uk/", "rating": 4.9, "reviewsCount": 597, "price": null, "description": null, "permanentlyClosed": false, "temporarilyClosed": false, "openingHours": [ { "day": "Monday", "dayLabel": "Monday", "hours": "8 am-5 pm", "periods": [ { "open": "08:00", "close": "17:00" } ] }, { "day": "Tuesday", "dayLabel": "Tuesday", "hours": "8 am-5:30 pm", "periods": [ { "open": "08:00", "close": "17:30" } ] }, { "day": "Wednesday", "dayLabel": "Wednesday", "hours": "8 am-5 pm", "periods": [ { "open": "08:00", "close": "17:00" } ] } ], "timezone": "Europe/London", "imageUrl": "https://lh3.googleusercontent.com/grass-cs/AABkmLfY-ngJQ8sz4J0jVTg7SE56pubLvqOShsDuEGCm1RpD3vJAZ0NPGLE8TAzQrY5MAvj145ArJKXaOghXJoiEJWFcSSlHIHRqLwGt1jJKwHR9J5NJX9314vNHzGNIpdToWSnuBfKEZg=w800-h600-k-no", "placeId": "ChIJYVVk-IJeeUgRuqS8KGHdmNI", "cid": "7492290227201009660", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJYVVk-IJeeUgRuqS8KGHdmNI" }, { "searchQuery": "dentists in Leeds", "rank": 2, "name": "Indigo Dental", "categories": [ "Dentist", "Dental hygienist", "Dental implants provider" ], "category": "Dentist", "address": "106 Dixon Ln, Wortley, Leeds LS12 4AD, United Kingdom", "street": "106 Dixon Ln", "city": "Leeds", "postalCode": "LS12 4AD", "state": null, "locality": "Leeds LS12 4AD", "cityLine": "Leeds LS12 4AD", "neighborhood": "Wortley", "country": "United Kingdom", "countryCode": "GB", "latitude": 53.7828516, "longitude": -1.5862535, "phone": "0113 263 2960", "phoneInternational": "+441132632960", "website": "http://www.indigodental.co.uk/", "rating": 4.9, "reviewsCount": 659, "price": null, "description": null, "permanentlyClosed": false, "temporarilyClosed": false, "openingHours": [ { "day": "Monday", "dayLabel": "Monday", "hours": "9 am-1 pm, 2-5 pm", "periods": [ { "open": "09:00", "close": "13:00" }, { "open": "14:00", "close": "17:00" } ] }, { "day": "Tuesday", "dayLabel": "Tuesday", "hours": "10 am-1 pm, 2-7 pm", "periods": [ { "open": "10:00", "close": "13:00" }, { "open": "14:00", "close": "19:00" } ] }, { "day": "Wednesday", "dayLabel": "Wednesday", "hours": "9 am-1 pm, 2-5 pm", "periods": [ { "open": "09:00", "close": "13:00" }, { "open": "14:00", "close": "17:00" } ] } ], "timezone": "Europe/London", "imageUrl": "https://lh3.googleusercontent.com/grass-cs/AABkmLetpAh_o8O2MwwCgEK-gtQrd4gLJm08VffHbNPYmiJfGkmXrqCqxHXbVl1SCXAZSflj-iJoY-xzoffB1p04LW1tHyO52Y9seOGaCpoJif99zqK62PtHFJh5qOqU_WNc48yKdHpE7fM9w8HS=w800-h600-k-no", "placeId": "ChIJt8b8qu9eeUgRhz5z2FSl_iY", "cid": "18200039744438293638", "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJt8b8qu9eeUgRhz5z2FSl_iY" } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "google_maps", "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search exactly as you would type it into Google Maps, ideally with a place. Also accepted as: q, search, searchQueries.", "schema": { "type": "string" }, "example": "dentists in Leeds" }, { "name": "limit", "in": "query", "required": false, "description": "Most places to return. Values above 50 are capped with a notice. Also accepted as: maxPlacesPerQuery.", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "example": 20 }, { "name": "contacts", "in": "query", "required": false, "description": "Also visit each business website and add emails and social links. Slower. Also accepted as: includeContactDetails.", "schema": { "type": "boolean", "default": false }, "example": false }, { "name": "country", "in": "query", "required": false, "description": "2-letter country code for the Google region (UK is accepted for GB).", "schema": { "type": "string", "pattern": "^[A-Za-z]{2}$", "default": "us" }, "example": "us" }, { "name": "language", "in": "query", "required": false, "description": "Language code for place names and categories.", "schema": { "type": "string", "default": "en" }, "example": "en" } ] } }, "/v1/youtube-videos": { "get": { "tags": [ "YouTube" ], "summary": "YouTube video stats", "description": "Views, likes, comment count, duration, publish date, channel and tags for video links, a search, or a channel's videos. Give one of urls, search or channel. No API key or quota needed. Give one of urls, search, channel. The captured example took 0.9 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/youtube_videos_item" } } } } ] }, "example": { "tool": "youtube-videos", "count": 1, "tookMs": 939, "runsOn": "cloudflare", "items": [ { "source": "url", "sourceValue": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "input": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "position": null, "videoId": "dQw4w9WgXcQ", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "channel": "Rick Astley", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "channelUrl": "https://www.youtube.com/@RickAstleyYT", "channelHandle": "@RickAstleyYT", "channelSubscribers": 4550000, "channelVerified": true, "collaborators": [], "views": 1829852208, "concurrentViewers": null, "likes": 19493734, "commentCount": 2460399, "commentCountIsExact": true, "duration": "3:33", "durationSec": 213, "publishDate": "2009-10-24", "publishedAt": "2009-10-25T06:57:33.000Z", "publishedTimeText": null, "publishedAtApprox": null, "dateText": "Oct 24, 2009", "isShort": false, "isLive": false, "isAgeRestricted": false, "isMembersOnly": false, "commentsTurnedOff": false, "tags": [ "rick astley", "Never Gonna Give You Up", "nggyu" ], "category": "Music", "hashtags": [ "#RickAstley", "#NeverGonnaGiveYouUp", "#OfficialMusicVideo" ], "badges": [], "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg", "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ #RickAstleyNever\nhttps://linktr.ee/rickastleynever\n\n“Never..." } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "youtube_videos", "parameters": [ { "name": "urls", "in": "query", "required": false, "description": "Comma-separated video links or 11-character video IDs (watch, youtu.be, Shorts and live links work). At most 50; extra entries are dropped with a notice. Give one of: urls, search, channel. Also accepted as: url, videoUrls, videos.", "schema": { "type": "string" }, "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ,jNQXAC9IVRw" }, { "name": "search", "in": "query", "required": false, "description": "A YouTube search query. Give one of: urls, search, channel. Also accepted as: query, q, searchQueries.", "schema": { "type": "string" }, "example": "" }, { "name": "channel", "in": "query", "required": false, "description": "A channel link, @handle or channel ID; lists that channel's videos. Give one of: urls, search, channel. Also accepted as: channels.", "schema": { "type": "string" }, "example": "" }, { "name": "limit", "in": "query", "required": false, "description": "Most videos to return for search or channel. Values above 50 are capped with a notice. Also accepted as: maxResults.", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "example": 20 }, { "name": "tab", "in": "query", "required": false, "description": "Channel tab to list (with channel). live is accepted for streams.", "schema": { "type": "string", "enum": [ "videos", "shorts", "streams" ], "default": "videos" }, "example": "videos" }, { "name": "sort", "in": "query", "required": false, "description": "Order of search results. date and rating are accepted but fall back to relevance on some routes, with a notice. Also accepted as: sortBy.", "schema": { "type": "string", "enum": [ "relevance", "date", "views", "rating" ], "default": "relevance" }, "example": "relevance" }, { "name": "uploadDate", "in": "query", "required": false, "description": "Search filter: upload date.", "schema": { "type": "string", "enum": [ "any", "hour", "today", "week", "month", "year" ], "default": "any" }, "example": "any" }, { "name": "duration", "in": "query", "required": false, "description": "Search filter: video length (short under 4 min, medium 4-20 min, long over 20 min).", "schema": { "type": "string", "enum": [ "any", "short", "medium", "long" ], "default": "any" }, "example": "any" } ] } }, "/v1/youtube-comments": { "get": { "tags": [ "YouTube" ], "summary": "YouTube comments", "description": "Comments of one YouTube video with author, likes, reply count and date, plus the video's total comment count. Replies are optional. The captured example took 0.8 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/youtube_comments_item" } } } } ] }, "example": { "tool": "youtube-comments", "count": 3, "tookMs": 808, "runsOn": "cloudflare", "items": [ { "videoId": "dQw4w9WgXcQ", "videoTitle": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "videoCommentCount": 2460399, "commentId": "Ugxzbv_ZeZXNRcfwsSF4AaABAg", "parentCommentId": null, "isReply": false, "text": "Is everyone going to ignore the fact that Rick Astley looks like a twelve year old boy but has a uniquely deep voice?", "author": "@candycake9531", "authorChannelId": "UCNLgzvqrGzFi5SEAbVkFchg", "authorIsVerified": false, "authorIsChannelOwner": false, "likes": 292000, "replyCount": 713, "publishedTimeText": "6 years ago", "publishedAtApprox": "2020-10-25T02:00:12.899Z", "isEdited": false, "isPinned": false, "isHeartedByCreator": false, "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=Ugxzbv_ZeZXNRcfwsSF4AaABAg" }, { "videoId": "dQw4w9WgXcQ", "videoTitle": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "videoCommentCount": 2460399, "commentId": "UgyEnXfdC-umwvTt8JF4AaABAg", "parentCommentId": null, "isReply": false, "text": "Gonna flag this for nudity so I can rick roll the YouTube staff", "author": "@Oatman69", "authorChannelId": "UCWf34D_s8K_m2vwBISIDWtg", "authorIsVerified": false, "authorIsChannelOwner": false, "likes": 569000, "replyCount": 723, "publishedTimeText": "6 years ago", "publishedAtApprox": "2020-10-25T02:00:12.899Z", "isEdited": false, "isPinned": false, "isHeartedByCreator": false, "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=UgyEnXfdC-umwvTt8JF4AaABAg" } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "youtube_comments", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "Video link or 11-character video ID. Also accepted as: video, videos, urls.", "schema": { "type": "string" }, "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, { "name": "limit", "in": "query", "required": false, "description": "Most top-level comments to return. Values above 300 are capped with a notice. Also accepted as: maxCommentsPerVideo.", "schema": { "type": "integer", "minimum": 1, "maximum": 300, "default": 50 }, "example": 50 }, { "name": "sort", "in": "query", "required": false, "description": "top (YouTube's ranking) or newest first.", "schema": { "type": "string", "enum": [ "top", "newest" ], "default": "top" }, "example": "top" }, { "name": "replies", "in": "query", "required": false, "description": "Also return replies to each comment (as items with isReply=true). Also accepted as: includeReplies.", "schema": { "type": "boolean", "default": false }, "example": false }, { "name": "maxReplies", "in": "query", "required": false, "description": "Most replies per comment when replies=true. At most 500 replies in total per request; lower values are applied with a notice. Values above 100 are capped with a notice. Also accepted as: maxRepliesPerComment.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "example": 20 } ] } }, "/v1/tiktok-profiles": { "get": { "tags": [ "Social" ], "summary": "TikTok profile stats", "description": "Followers, following, likes and video count, bio, verification and avatar for TikTok accounts. The captured example took 4.9 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/tiktok_profiles_item" } } } } ] }, "example": { "tool": "tiktok-profiles", "count": 1, "tookMs": 4867, "runsOn": "cloudflare", "items": [ { "input": "nasa", "handle": "nasa", "username": "nasa", "nickname": "NASA", "url": "https://www.tiktok.com/@nasa", "userId": "7664638705177150477", "secUid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6", "verified": true, "privateAccount": false, "isOrganization": true, "bio": "Making the seemingly impossible, possible.✨", "bioLink": "science.nasa.gov/feature/artemis-ii-preliminary-lunar-science-report", "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=b515cc14&x-expires=1792980000&x-signature=lsUsOA4KhGr7qVDRn%2FzfiiHXJLE%3D&t=4d5b...", "language": "en", "createdAt": "2026-07-20T15:55:49.000Z", "followers": 2131222, "following": 23, "likes": 11319717, "videos": 59, "friends": 17, "likesGiven": 0, "isLive": false, "isSeller": false, "commerceCategory": null, "favoritesPublic": false, "commentSetting": 0, "duetSetting": 0, "stitchSetting": 0, "downloadSetting": 0 } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "tiktok_profiles", "parameters": [ { "name": "usernames", "in": "query", "required": true, "description": "Comma-separated usernames (with or without @) or profile links. At most 50; extra entries are dropped with a notice. Also accepted as: username, profiles, handles.", "schema": { "type": "string" }, "example": "nasa,natgeo" } ] } }, "/v1/amazon-search": { "get": { "tags": [ "E-commerce" ], "summary": "Amazon search results", "description": "Products from an Amazon search: ASIN, title, price, list price, rating, review count, 'bought in past month' and badges. Sponsored results are included and marked with isSponsored. The captured example took 1.1 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/amazon_search_item" } } } } ] }, "example": { "tool": "amazon-search", "count": 3, "tookMs": 1144, "runsOn": "cloudflare", "items": [ { "search": "espresso machine", "position": 1, "asin": "B0GY74JMX3", "title": "Espresso Machine 20 Bar, Compact Espresso Coffee Machine with Milk Frother, Stainless Steel Coffee Maker with 34oz Removable Water Tank, Cappuccino Machine for Home, Office, Latte (Silver)", "url": "https://www.amazon.com/dp/B0GY74JMX3", "price": 99.98, "listPrice": 159.99, "unitPrice": null, "unitPriceUnit": null, "currency": "USD", "priceText": "$99.98", "rating": 4.5, "reviewsCount": 142, "boughtPastMonth": "1K+", "badge": null, "badges": [], "isSponsored": true, "image": "https://m.media-amazon.com/images/I/712in44KnCL._AC_UL320_.jpg", "marketplace": "amazon.com" }, { "search": "espresso machine", "position": 2, "asin": "B0GZMP7MNT", "title": "20 Bar Espresso Machine with Milk Frothing Steam Wand, Stainless", "url": "https://www.amazon.com/dp/B0GZMP7MNT", "price": 129.99, "listPrice": null, "unitPrice": null, "unitPriceUnit": null, "currency": "USD", "priceText": "$129.99", "rating": 4.6, "reviewsCount": 32, "boughtPastMonth": null, "badge": null, "badges": [], "isSponsored": true, "image": "https://m.media-amazon.com/images/I/71vQsz3tGtL._AC_UL320_.jpg", "marketplace": "amazon.com" } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "amazon_search", "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search keywords as typed on Amazon. Also accepted as: q, search, searches.", "schema": { "type": "string" }, "example": "espresso machine" }, { "name": "marketplace", "in": "query", "required": false, "description": "Amazon site to search. A full URL such as https://www.amazon.ca/ is accepted.", "schema": { "type": "string", "enum": [ "amazon.com", "amazon.ca", "amazon.com.mx", "amazon.com.br" ], "default": "amazon.com" }, "example": "amazon.com" }, { "name": "limit", "in": "query", "required": false, "description": "Most products to return. Values above 60 are capped with a notice. Also accepted as: maxProductsPerSearch.", "schema": { "type": "integer", "minimum": 1, "maximum": 60, "default": 20 }, "example": 20 } ] } }, "/v1/linkedin-jobs": { "get": { "tags": [ "Jobs" ], "summary": "LinkedIn job search", "description": "Public LinkedIn job listings: title, company, location, salary (when shown), posted date and applicant count. With details=true it adds the full description, seniority, employment type and job function. The captured example took 6.0 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/linkedin_jobs_item" } } } } ] }, "example": { "tool": "linkedin-jobs", "count": 3, "tookMs": 5968, "runsOn": "apify", "items": [ { "search": "data engineer", "searchLocation": "London", "jobId": "4480480883", "title": "Data Engineer", "company": "LA International", "companyUrl": "https://uk.linkedin.com/company/la-international", "location": "London Area, United Kingdom", "workplaceType": null, "postedDate": "2026-10-20", "postedText": "3 days ago", "salary": null, "benefits": "Actively Hiring", "url": "https://www.linkedin.com/jobs/view/4480480883", "companyLogo": "https://media.licdn.com/dms/image/v2/D4E0BAQEPNWtdDC_HCA/company-logo_100_100/company-logo_100_100/0/1728892396784/la_international_logo?e=2147483647&v=beta&t=FJDOMX4bOxe3KB4kXy2Yl-4vJZ85BvJqWcghOfJ45ew" }, { "search": "data engineer", "searchLocation": "London", "jobId": "4454978745", "title": "Data Engineer", "company": "Cantor Fitzgerald", "companyUrl": "https://www.linkedin.com/company/cantor-fitzgerald", "location": "London, England, United Kingdom", "workplaceType": null, "postedDate": "2026-10-23", "postedText": "9 hours ago", "salary": null, "benefits": "Actively Hiring", "url": "https://www.linkedin.com/jobs/view/4454978745", "companyLogo": "https://media.licdn.com/dms/image/v2/C510BAQGym2qGXf9I8w/company-logo_100_100/company-logo_100_100/0/1631345509366?e=2147483647&v=beta&t=XXNzMKdyK1lztU-AD0R36l9Yc1oakgxCmZtnCz8wYzw" } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "linkedin_jobs", "parameters": [ { "name": "keywords", "in": "query", "required": true, "description": "Job title or keywords. Also accepted as: query, q, search, searches.", "schema": { "type": "string" }, "example": "data engineer" }, { "name": "location", "in": "query", "required": false, "description": "City, region or country. An unrecognised location returns an error instead of worldwide results.", "schema": { "type": "string" }, "example": "" }, { "name": "posted", "in": "query", "required": false, "description": "Only jobs posted within this period. 24h, 7d and 30d are accepted too. Also accepted as: postedWithin.", "schema": { "type": "string", "enum": [ "any", "day", "week", "month" ], "default": "any" }, "example": "any" }, { "name": "limit", "in": "query", "required": false, "description": "Most jobs to return. Values above 50 are capped with a notice. Also accepted as: maxJobsPerSearch.", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }, "example": 20 }, { "name": "details", "in": "query", "required": false, "description": "Open each job and add the full description and job criteria. Slower. Also accepted as: includeDetails.", "schema": { "type": "boolean", "default": false }, "example": false }, { "name": "distance", "in": "query", "required": false, "description": "Search radius in miles around location (needs location). Also accepted as: radius.", "schema": { "type": "string", "enum": [ "0", "5", "10", "25", "50", "100" ] }, "example": "" }, { "name": "jobTypes", "in": "query", "required": false, "description": "Comma-separated: fulltime, parttime, contract, temporary, internship, volunteer, other. Applied from each job's details. At most 7; extra entries are dropped with a notice. Also accepted as: jobType, employmentTypes, employmentType.", "schema": { "type": "string" }, "example": "" }, { "name": "experienceLevels", "in": "query", "required": false, "description": "Comma-separated: internship, entry, associate, midsenior, director, executive, notapplicable. Applied from each job's details. At most 7; extra entries are dropped with a notice. Also accepted as: experienceLevel, seniority, seniorityLevels.", "schema": { "type": "string" }, "example": "" } ] } }, "/v1/linkedin-company": { "get": { "tags": [ "Leads" ], "summary": "LinkedIn company profiles", "description": "Public LinkedIn company pages: description, website, industry, size, headquarters, founded year, specialties, follower count and locations. With posts=true it adds recent posts (items with type=post). The captured example took 0.8 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/linkedin_company_item" } } } } ] }, "example": { "tool": "linkedin-company", "count": 1, "tookMs": 752, "runsOn": "cloudflare", "items": [ { "type": "company", "input": "stripe", "slug": "stripe", "pageType": "company", "companyId": "2135371", "companyUrn": "urn:li:organization:2135371", "name": "Stripe", "linkedinUrl": "https://www.linkedin.com/company/stripe", "tagline": "Help increase the GDP of the internet.", "description": "Stripe builds programmable financial services. Millions of companies—from the world’s largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headqu...", "website": "https://stripe.com/", "industry": "Technology, Information and Internet", "companySize": "5,001-10,000 employees", "employeesOnLinkedIn": 16694, "followers": 1784565, "headquarters": "South San Francisco, California", "address": { "street": "354 Oyster Point Blvd", "city": "South San Francisco", "region": "California", "postalCode": "94080", "country": "US" }, "locations": [ { "address": "354 Oyster Point Blvd, South San Francisco, California 94080, US", "primary": true }, { "address": "1 Wilton Park, Wilton Terrace, Dublin, County Dublin D02 FX04, IE", "primary": false }, { "address": "920 5th Ave, Seattle, Washington 98104, US", "primary": false } ], "organizationType": "Privately Held", "founded": 2010, "specialties": [], "logo": "https://media.licdn.com/dms/image/v2/D560BAQE2ZfJyfn-VCg/company-logo_200_200/B56ZlyKwpUKIAI-/0/1758557047806/stripe_logo?e=2147483647&v=beta&t=En4Hm6NDGbDTYCoOQ0Ko5Ne2gylx0WRb0yL2GlOeXBQ", "similarPages": [ { "name": "Atlassian", "industry": "Software Development", "location": "Sydney, NSW", "linkedinUrl": "https://www.linkedin.com/company/atlassian" }, { "name": "Airbnb", "industry": "Software Development", "location": "San Francisco, CA", "linkedinUrl": "https://www.linkedin.com/company/airbnb" }, { "name": "Revolut", "industry": "Financial Services", "location": "London, England", "linkedinUrl": "https://www.linkedin.com/company/revolut" } ], "affiliatedPages": [ { "name": "Stripe Partner Ecosystem", "industry": "Internet Publishing", "location": "South San Francisco, California", "linkedinUrl": "https://www.linkedin.com/showcase/stripe-partner-ecosystem" }, { "name": "Stripe Support", "industry": "Technology, Information and Internet", "location": null, "linkedinUrl": "https://www.linkedin.com/showcase/stripe-support" }, { "name": "Stripe Community Builders", "industry": "Technology, Information and Internet", "location": null, "linkedinUrl": "https://www.linkedin.com/showcase/stripe-community-builders" } ] } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "linkedin_company", "parameters": [ { "name": "companies", "in": "query", "required": true, "description": "Comma-separated company page links, slugs or names. At most 20; extra entries are dropped with a notice. Also accepted as: company, urls.", "schema": { "type": "string" }, "example": "stripe,https://www.linkedin.com/company/microsoft/" }, { "name": "posts", "in": "query", "required": false, "description": "Also return the company's recent public posts. Also accepted as: includeRecentPosts.", "schema": { "type": "boolean", "default": false }, "example": false } ] } }, "/v1/airbnb": { "get": { "tags": [ "Travel" ], "summary": "Airbnb search", "description": "Airbnb listings for a place and optional dates: name, type, rating, review count, nightly and total price, coordinates and photos. The captured example took 1.2 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/airbnb_item" } } } } ] }, "example": { "tool": "airbnb", "count": 3, "tookMs": 1241, "runsOn": "cloudflare", "items": [ { "location": "Lisbon", "listingId": "1427419793394969443", "url": "https://www.airbnb.com/rooms/1427419793394969443?check_in=2026-12-10&check_out=2026-12-13&adults=2", "name": "The Perch – Panoramic Duplex Perch", "title": "Apartment in Lisbon", "roomType": "Apartment", "subtitle": "The Perch – Panoramic Duplex Perch", "bedrooms": 1, "beds": 1, "bathrooms": null, "guests": 2, "rating": 4.88, "reviewsCount": 92, "isNew": false, "priceLabel": "€397 total", "totalPrice": 396.86, "originalPrice": null, "taxes": 24, "totalIncludesTaxes": true, "priceBeforeTaxes": 372.86, "nights": 3, "nightsBreakdown": "3 nights x €129.17", "pricePerNight": 129.17, "badges": [ "Guest favorite" ], "latitude": 38.713, "longitude": -9.1319, "photos": [ "https://a0.muscache.com/im/pictures/hosting/Hosting-U3RheVN1cHBseUxpc3Rpbmc6MTQyNzQxOTc5MzM5NDk2OTQ0Mw==/original/9edb6341-07b0-4eb3-b673-4f9c9d2933ed.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-1427419793394969443/original/ef96ac1d-d653-41cb-bfd0-89f99c654fe9.jpeg", "https://a0.muscache.com/im/pictures/hosting/Hosting-U3RheVN1cHBseUxpc3Rpbmc6MTQyNzQxOTc5MzM5NDk2OTQ0Mw==/original/8e2a19ef-a394-4e77-b304-4a2536e17b3d.jpeg" ], "checkIn": "2026-12-10", "checkOut": "2026-12-13", "sampleDates": false, "currency": "EUR" }, { "location": "Lisbon", "listingId": "31774369", "url": "https://www.airbnb.com/rooms/31774369?check_in=2026-12-10&check_out=2026-12-13&adults=2", "name": "Lovely Spot in Alfama", "title": "Apartment in Lisbon", "roomType": "Apartment", "subtitle": "Lovely Spot in Alfama", "bedrooms": 1, "beds": 1, "bathrooms": null, "guests": 2, "rating": 4.82, "reviewsCount": 334, "isNew": false, "priceLabel": "€259 total", "totalPrice": 258.09, "originalPrice": null, "taxes": 24, "totalIncludesTaxes": true, "priceBeforeTaxes": 234.09, "nights": 3, "nightsBreakdown": "3 nights x €79.30", "pricePerNight": 79.3, "badges": [ "Guest favorite" ], "latitude": 38.71367, "longitude": -9.12775, "photos": [ "https://a0.muscache.com/im/pictures/miso/Hosting-31774369/original/7d887502-a968-4188-a16c-83ecc3361603.jpeg", "https://a0.muscache.com/im/pictures/e8c64c91-e16c-4672-80d5-1a5a6b48b209.jpg", "https://a0.muscache.com/im/pictures/10335ddf-8839-42fc-acf3-08b0bc2d2f60.jpg" ], "checkIn": "2026-12-10", "checkOut": "2026-12-13", "sampleDates": false, "currency": "EUR" } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "airbnb", "parameters": [ { "name": "location", "in": "query", "required": true, "description": "City, area or address to search. Also accepted as: locations, q, query.", "schema": { "type": "string" }, "example": "Lisbon" }, { "name": "checkin", "in": "query", "required": false, "description": "Check-in date, YYYY-MM-DD. Must not be in the past. Also accepted as: checkIn.", "schema": { "type": "string", "format": "date" }, "example": "" }, { "name": "checkout", "in": "query", "required": false, "description": "Check-out date, YYYY-MM-DD. Needs checkin; at most 365 nights. Also accepted as: checkOut.", "schema": { "type": "string", "format": "date" }, "example": "" }, { "name": "adults", "in": "query", "required": false, "description": "Number of adult guests (1-16; outside this range is a 400).", "schema": { "type": "integer", "minimum": 1, "maximum": 16, "default": 1 }, "example": 1 }, { "name": "currency", "in": "query", "required": false, "description": "3-letter currency code for prices.", "schema": { "type": "string", "pattern": "^[A-Za-z]{3}$", "default": "USD" }, "example": "USD" }, { "name": "limit", "in": "query", "required": false, "description": "Most listings to return. Values above 60 are capped with a notice. Also accepted as: maxListingsPerLocation.", "schema": { "type": "integer", "minimum": 1, "maximum": 60, "default": 20 }, "example": 20 }, { "name": "minPrice", "in": "query", "required": false, "description": "Lowest nightly price, in currency.", "schema": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, { "name": "maxPrice", "in": "query", "required": false, "description": "Highest nightly price, in currency.", "schema": { "type": "integer", "minimum": 0, "maximum": 1000000 } } ] } }, "/v1/website-contacts": { "get": { "tags": [ "Leads" ], "summary": "Website contact finder", "description": "Emails, phone numbers and social profiles published on a website's homepage and its contact and about pages. One item per website. The captured example took 1.6 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/website_contacts_item" } } } } ] }, "example": { "tool": "website-contacts", "count": 1, "tookMs": 1572, "runsOn": "cloudflare", "items": [ { "input": "buffer.com", "website": "https://buffer.com", "domain": "buffer.com", "finalUrl": "https://buffer.com", "title": "Buffer: Social media management for everyone", "description": "Use Buffer to manage your social media so that you can create and share your content everywhere, consistently. Try our forever free plan or upgrade for more.", "emails": [ "hello@buffer.com", "legal@buffer.com", "copyright@buffer.com" ], "phones": [], "phonesUncertain": [ "+1-800-778-7879", "(800) 952-5210" ], "socials": { "discord": [ "https://discord.gg/aQdKKr6kDY" ], "instagram": [ "https://www.instagram.com/buffer", "https://www.instagram.com/_nyxel_" ], "facebook": [ "https://www.facebook.com/bufferapp", "https://www.facebook.com/MTK911", "https://www.facebook.com/Desihack" ], "bluesky": [ "https://bsky.app/profile/buffer.com" ], "x": [ "https://x.com/buffer", "https://x.com/BugsgaloreSec", "https://twitter.com/rakesh0x7" ], "linkedin": [ "https://www.linkedin.com/company/bufferapp", "https://www.linkedin.com/in/moncef-djouadi", "https://www.linkedin.com/in/akshachudasama23" ], "threads": [ "https://www.threads.net/@buffer" ], "github": [ "https://github.com/bufferapp", "https://github.com/rcs" ] }, "contactPages": [ "https://buffer.com/legal" ], "pagesScraped": 6 } ] } } } }, "400": { "description": "Missing or invalid parameter. Nothing is run and nothing is counted.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Missing parameter: query. Example: /v1/google-maps?query=dentists+in+Leeds&country=gb&limit=10" } } } }, "401": { "description": "No valid key. Through RapidAPI this is handled for you.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Unauthorised. Get access via RapidAPI: https://rapidapi.com/CharlieGallie/api/purfled-data-api" } } } }, "404": { "description": "Unknown endpoint, or every input was not found (the per-input error items are included).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Profile not found or unavailable", "items": [ { "input": "zq9xk2nouser7", "handle": "zq9xk2nouser7", "error": "Profile not found or unavailable" } ] } } } }, "422": { "description": "Every input failed for a reason other than not found, or the job rejected the input.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "The job failed. Check the input and try again." } } } }, "429": { "description": "Purfled's daily capacity for this service is used up (separate from your plan's quota). Resets at 00:00 UTC.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Purfled's daily capacity for this service is used up (this is Purfled's own limit, not your plan's). It resets at 00:00 UTC." } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } }, "503": { "description": "Temporary problem upstream or on our side, or the job took too long. Retry after Retry-After seconds, or lower limit.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Busy, please retry in a few seconds" } } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "schema": { "type": "integer" } } } } }, "operationId": "website_contacts", "parameters": [ { "name": "domains", "in": "query", "required": true, "description": "Comma- or space-separated domains or website links. At most 20; extra entries are dropped with a notice. Also accepted as: domain, websites, urls, url.", "schema": { "type": "string" }, "example": "basecamp.com,stripe.com" } ] } }, "/v1/telegram-channel": { "get": { "tags": [ "Social" ], "summary": "Telegram channel posts", "description": "Recent posts of a public Telegram channel with views, reactions, media and links. The first item is the channel record (type=channel); posts have type=post. The response's posts field counts the posts. The captured example took 0.1 s; most calls take 1-40 s, so allow at least 60 s.", "responses": { "200": { "description": "Results. count is the number of items; notices explain any limit that was applied. The example is a real response, trimmed to 2 items with long text shortened.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Envelope" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/telegram_channel_item" } } } } ] }, "example": { "tool": "telegram-channel", "count": 4, "posts": 3, "tookMs": 90, "runsOn": "cloudflare", "items": [ { "type": "channel", "channel": "durov", "url": "https://t.me/durov", "title": "Pavel Durov", "description": "Founder of Telegram.", "verified": true, "subscribers": 10300000, "photos": 102, "videos": 47, "files": null, "links": 200, "avatarUrl": "https://cdn4.telesco.pe/file/E8vl3Qt3vpWmvI_fFS9Hm8KpChRnmlDzOJcYbt3-ZrvdCTLGorjFbLe7Q1JW5kRi2mFrWzsqcVHYaS4r3EOb8NFBVMVgeFZ3AiNhMoiaePZ89TFqlCsqsuxyhV5tuRqgU15r98_JX7P9QzbFX6ZBDyBkmmHQF7oIt0D0xxRosG__SipdP5N0JUY0zOAQP949PfREUTLYeEyQLdYd...", "scrapedAt": "2026-10-24T02:00:14.072Z" }, { "type": "post", "channel": "durov", "id": 552, "url": "https://t.me/durov/552", "date": "2026-10-11T14:52:40+00:00", "edited": false, "author": "Pavel Durov", "text": "✨ Designers × AI\n\n🆕 The mockup era is over. Today’s AI tools give every designer a superpower: you can now craft your ideas, not just draw them. \n\nThe gap between “what if…?” and “look, it works!” has never been smaller, and that changed...", "textHtml": "✨ Designers × AI