[go: up one dir, main page]

Skip to contentLurkAPI

What changed in the API

New endpoints, and changes to request params, response fields and prices, newest first.

Also as changelog.md for agents and LLMs.

    • ChangedTikTok

      An account TikTok shows only to logged-in visitors now answers 403 not_public, charged, instead of a free upstream_error that said to retry. Retrying never got these.

    • ChangedTikTok

      Searches TikTok puts a notice above (anything about AI, for one) now return their videos. They answered upstream_error, whatever the retries.

    • ChangedTikTok

      A sound TikTok no longer shows now answers 404 not_found, charged, instead of a free upstream_error that said to retry.

    • ChangedLinkedIn

      A profile LinkedIn won't show logged-out visitors (or one that doesn't exist) now answers 403 not_public, charged, instead of a free upstream_error that said to retry. Retrying never got these.

    • ChangedFacebook

      Paramsurl

      Video URLs with a title in the path, such as https://www.facebook.com/kingarthurbaking/videos/apple-butter-apple-galette/715227309716913/, are accepted.

    • ChangedWeb
      Was
      4 credits; 14 if a captcha is solved
      Now
      1 credit; 11 if a captcha is solved

      A page rendered in a real browser now costs the same as a plain request.

    • ChangedWeb

      Paramsmax_creditsFieldsbilling

      Was
      1 credit; +3 if a browser renders it, +4 if it needs a residential IP, +13 if a browser renders it on a residential IP, +10 if a captcha is solved
      Now
      1 credit; +3 if a browser on separate IPs gets it, +4 if it needs a residential IP, +13 if a browser renders it on a residential IP, +10 if a captcha is solved

      Our browser no longer adds credits, so max_credits=1 now allows it. The unblocker still adds 3, shown as unblock in billing.breakdown (it was render).

    • Changed2 endpoints
      TikTok
      Instagram
      Was
      1 credit; 5 if speech-to-text runs
      Now
      1 credit; 2 if speech-to-text runs

      Speech-to-text now adds 1 credit instead of 4: a transcript it makes costs 2 credits. With captions, or one we already made, it's still 1.

    • ChangedInstagram

      Paramsfirst

      Returns at most 12 posts a page, the most Instagram now shows signed-out visitors; page with end_cursor for more. A larger first still works.

    • ChangedFacebook

      Paramsurl

      Page URLs with a hyphen in the username, such as https://www.facebook.com/harley-davidson, are accepted.

    • Changed6 endpoints
      TikTok
      Instagram

      Paramsmax_credits

      New: cap what a call can cost. A paid step that would go past max_credits doesn't run, and a call that can't be done within it fails with 402 over_max_credits, free. Every endpoint takes it; these are the ones whose price varies.

    • ChangedInstagram

      Fieldsfollower_count

      New: the account's follower count comes with its reels, so engagement rate takes one call instead of two.

    • ChangedTikTok

      FieldsfollowerCount

      New: the creator's follower count comes with their posts, rounded as TikTok shows it there, so engagement per follower takes one call.

    • ChangedTikTok

      Paramscdn_urlFieldscdnUrl

      New: cdn_url=true adds cdnUrl, the MP4 on TikTok's CDN. It plays from anywhere, where video.playUrl can refuse visitors outside the US.

    • AddedeBay2 credits each

      A new platform: search active eBay listings, and read any listing by id or URL. Priced at 2 credits for the extra work eBay's pages need.

    • AddedGoogle1 credit each

      Google News and the search box's suggestions, for coverage and keyword research.

    • AddedGoogle1 credit each

      Businesses on Google Maps with their contacts, hours and ratings, and what customers say about them.

    • AddedLinkedIn1 credit each

      A member's public profile, and LinkedIn's public job search and listings.

    • AddedFacebook1 credit each

      A Page's or public person's timeline and events, and the top comments on a post.

    • AddedInstagram1 credit each

      The reels Instagram ranks for a keyword, and the accounts it suggests next to a profile.

    • AddedTikTok1 credit each

      Videos for a keyword, a TikTok Shop store's catalog with its sales, and what Shop's search box suggests.

    • ChangedFacebook

      Fieldscategoryemailphoneaddresswebsitesratingprice_range

      New: the category and contact details a Page shows in its Intro card, and a business's rating and price range.

    • AddedWeb

      Each of Auto's strategies on its own at a fixed price, and Custom to chain the ones you accept, so you know what a page can cost before you call.

    • ChangedWeb

      Fieldsbilling

      Was
      1 credit; +4 if a browser renders it, +9 if it needs a residential IP, +10 if a captcha is solved
      Now
      1 credit; +3 if a browser renders it, +4 if it needs a residential IP, +13 if a browser renders it on a residential IP, +10 if a captcha is solved

      Cheaper paid steps, each now priced like the fixed-price endpoint that does the same. The new billing says what each call cost and why.

    • ChangedWeb

      ParamsmainFieldstitle

      New: main=true keeps only the page's own content in markdown or text, without menus, sidebars and cookie banners; title is the page's <title>.

    • ChangedTikTok

      Fieldsurl

      New: the video's link, also when you passed a share link.

    • ChangedInstagram

      Fieldsusercaptiontaken_atdisplay_url

      New: the post's author, caption, time and preview image come with the transcript.

    • AddedWeb1 credit; +4 if a browser renders it, +9 if it needs a residential IP, +10 if a captcha is solved

      A new platform: any public web page as HTML, markdown or text. Auto escalates only as far as the site makes it, and you pay for what got the page.

    • ChangedX (Twitter)

      Fieldspollarticletextmediacounts

      New: a tweet's poll and X article, also on quoted and retweeted tweets. On a retweet, text, media and counts are now the original's, as x.com shows them.

    • ChangedTruth Social

      Fieldsreblog.quotetext

      New: the post a ReTruth's original quotes. text is now empty on a ReTruth, whose original is in reblog, and leaves out a quote post's link to the quoted post, as Truth Social shows it.

    • ChangedInstagram

      Fieldstotal_clips_count

      Now always null: signed-out Instagram shows the same placeholder count for every account.

    • ChangedInstagram

      Paramsurl

      Now also takes /reels/, m.instagram.com and instagr.am links, and links from a profile grid. Media transcript takes carousels too, and transcribes the first video.

    • ChangedInstagram

      Fieldsusertags

      New: the accounts tagged in a post, and in each carousel item.

    • ChangedThreads

      Fieldsquoted_postlink_previewtopic

      New: the post it quotes, its link card and its topic tag.

    • ChangedFacebook

      Fieldslink

      New: the preview card of a link the post shares.

    • ChangedReddit

      Fieldscrosspost_parent_listpoll_datagallery_datamedia

      New: a crosspost's original, polls, galleries and videos, in Reddit's own shape.

    • ChangedTikTok

      Fieldstitle

      New: a photo post's title, shown above its caption.

    • ChangedTikTok

      Fieldsimage_list

      New: the photos in a photo comment.

    • ChangedGoogle

      FieldstargetingCategorieseeaStatsusStats

      New: the targeting Google discloses, and its totals for the European Economic Area and the US.

    • ChangedGoogle

      FieldspoliticalRegions

      New: the regions where an election ad ran.

    • ChangedLinkedIn

      FieldsdocumentresharedPost

      New: a post's attached document, and the post a repost shares.

    • ChangedLinkedIn

      FieldsmessageeventcarouselCards

      New: the details of message, event and carousel ads.

    • ChangedLinkedIn

      Fieldstargeting

      Now one row per targeting parameter (Audience, Company, Job…) after the language and location rows, as LinkedIn's table lists them.

    • ChangedBluesky

      FieldstrustedVerifier

      New: whether the account can verify others, like bsky.app.

    • ChangedTelegram

      Fieldspoll

      New: a poll's question, options and voters.

    • ChangedLink-in-bio

      FieldslinksparentId

      links now includes the cards inside each group, right after the group's card; the new parentId names the group.