Skip to main content
Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.
Send a parser’s options in the same format, like {"type": "json", "parser": "reddit-search", "options": {...}}. See Parsers for how they work. A Reddit search page with a q query, on reddit.com/search or inside a subreddit. Add type=sr to the page for communities or type=user for people.
  • Example page: https://www.reddit.com/search/?q=web+scraping&sort=top&t=year
  • Returns: A list of posts: results, cursor, page, total.
  • Options: subreddit, cursor (The cursor from the previous response. Send it as is), query (Words to find. With any sort other than relevance, a query of several words matches that exact phrase; use sort relevance to match the words anywhere in a post. Quotes, AND, OR, NOT, title:, selftext:, author:, subreddit: and site: are used as typed), type, sort (relevance matches the words anywhere in a post. hot, top, newest and mostComments match the exact phrase, so a query of several words only returns posts containing that phrase), time (Reddit’s own time filter. Leave out for Reddit’s default).
  • Price: 1 credit per call. Works without an API key.

reddit-post

A Reddit post page or a redd.it short link. Send options view discussions to list the other subreddits where the same link was shared.

reddit-subreddit

A subreddit page, like reddit.com/r/programming/ or reddit.com/r/programming/top/?t=week.

reddit-user

A Reddit user page, like reddit.com/user/spez or reddit.com/user/spez/comments.
  • Example page: https://www.reddit.com/user/spez/
  • Returns: A list of posts: results, cursor, page, total.
  • Options: tab, sort (Reddit’s own sort), time (Reddit’s own time filter. Leave out for Reddit’s default), cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

reddit-subreddits

The Reddit list of popular subreddits, reddit.com/subreddits.
  • Example page: https://www.reddit.com/subreddits/
  • Returns: A list of profiles: results, cursor, page, total.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

instagram-post

An Instagram post, reel or share link.
  • Example page: https://www.instagram.com/p/DeuOR-CjKE9/
  • Returns: One post: id, url, title, text, author, community, publishedAt, likes, comments, shares, views, media, hashtags.
  • Price: 1 credit per call.

instagram-profile

An Instagram profile page, like instagram.com/natgeo. Its reels tab, like instagram.com/natgeo/reels, or options view reels on the profile page, returns the reels.
  • Example page: https://www.instagram.com/natgeo/
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

instagram-comments

An Instagram post, reel or share link.
  • Example page: https://www.instagram.com/p/DeuOR-CjKE9/
  • Returns: A list of comments: results, cursor, page, total.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

instagram-feed

An Instagram hashtag, location or keyword search page, like instagram.com/explore/tags/travel.

x-profile

An X profile page, like x.com/nasa. Send options view posts for the profile’s posts.
  • Example page: https://x.com/nasa
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call. Works without an API key.

x-post

An X post page, like x.com/nasa/status/<id>.
  • Example page: https://x.com/NASA/status/2118041009766678695
  • Returns: One post: id, url, title, text, author, community, publishedAt, likes, comments, shares, views, media, hashtags.
  • Price: 1 credit per call. Works without an API key.

threads-profile

A Threads profile page, like threads.com/@nasa. Send options view posts for the profile’s posts.
  • Example page: https://www.threads.com/@nasa
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

threads-post

A Threads post page, like threads.com/@nasa/post/<code>.
  • Example page: https://www.threads.com/@nasa/post/DfVbdbGAhkX
  • Returns: One post: id, url, title, text, author, community, publishedAt, likes, comments, shares, views, media, hashtags.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.
A Pinterest pin or video search page with a q query, like pinterest.com/search/pins/?q=kitchen.

pinterest-pin

A Pinterest pin page or a pin.it short link.

pinterest-board

A Pinterest board page, like pinterest.com/<user>/<board>/.

pinterest-profile

A Pinterest profile page, like pinterest.com/marthastewart/.
  • Example page: https://www.pinterest.com/marthastewart/
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

facebook-page

A Facebook page, like facebook.com/NASA. Send options view posts for the page’s posts.
  • Example page: https://www.facebook.com/NASA
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.

facebook-post

A Facebook post, reel or video page, or an fb.watch link.

facebook-comments

A Facebook post, reel or video page, or an fb.watch link.

linkedin-company

A LinkedIn company page.
  • Example page: https://www.linkedin.com/company/microsoft
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Price: 1 credit per call.

linkedin-profile

A LinkedIn profile page.
  • Example page: https://www.linkedin.com/in/satyanadella
  • Returns: One profile: id, url, handle, name, bio, avatarUrl, isVerified, followers, following, posts, website, location, category.
  • Price: 1 credit per call.

linkedin-posts

A LinkedIn profile or company page.
  • Example page: https://www.linkedin.com/company/microsoft
  • Returns: A list of posts: results, cursor, page, total.
  • Options: cursor (The cursor from the previous response. Send it as is).
  • Price: 1 credit per call.