Home · Extract · Social posts and channels

Extract social posts and channels: what each source really returns

A Twitch channel, a Mastodon post, a post on X and a Pinterest pin, each as fields. How much comes back depends on the source: a Mastodon post returns the text, author and counts; a post on X returns the title, text preview and date; a Pinterest pin returns the page's own title, description and image. A YouTube video or channel, a Substack post, a podcast page and a Bluesky post return their title, author and image, and the counts where the source gives them. A LinkedIn job posting returns its title, company, location, how long ago it was posted, the description and the criteria LinkedIn lists for it.

fact Every field table below is from a real response captured on 19 November 2026 from https://api.foxapis.com. Fields that came back empty are counted, not shown.

Which endpoints return it

EndpointWhat it returnsCredits per callCredits per 1,000 calls
POST /v1/social/twitch/channelA Twitch channel by name: followers, partner status, whether it is live and its latest video.22,000
POST /v1/social/mastodon/postOne Mastodon post by its address: text, author, counts and date.22,000
POST /v1/social/twitter/postOne post on X by its address: the headline text, date and author picture.33,000
POST /v1/visual/pinterest/pinOne Pinterest pin by its address: title, description and images.22,000
POST /v1/social/bluesky/post22,000
POST /v1/content/youtube/videoA YouTube video by address: title, channel name and address, and the thumbnail.22,000
POST /v1/content/youtube/channelA YouTube channel by address: name, description, channel id and image.22,000
POST /v1/content/substack/postA Substack post by address: title, description, the publication address and image.22,000
POST /v1/content/podcast/episodeA podcast page by address: title, description, the show's author and artwork.22,000
POST /v1/talent/linkedin/jobA LinkedIn job posting by address: title, company and its page, location, posted-ago, applicant band, description and criteria (seniority, employment type, function, industries).44,000
POST /v1/content/substack/publicationA newsletter home page by address: title, description, image and a note on what it returns.22,000

What your volume costs in credits

 

Calculated by us.Formula Credits per call from the catalog times your calls; the smallest plan whose monthly credits cover it. Plans and what they cost: pricing.

Get a key and run this on your own inputs

POST /v1/social/twitch/channel

A Twitch channel by name: followers, partner status, whether it is live and its latest video.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 629 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
platformstringtwitch
loginstringtwitch
display_namestringTwitch
broadcaster_typestringpartner
descriptionstringTwitch is where thousands of communities come together for whatever, every day.
profile_image_urlstringhttps://static-cdn.jtvnw.net/jtv_user_pictures/e437c251-ced5-476f-b3c6-fd6686c51550-profile_image-300x300.png
account_createdstring2007-05-22T10:39:54Z
total_viewsnumber0
followersnumber2506487
is_livebooleanfalse
latest_vod_titlestringGTAVI Countdown
latest_vod_urlstringhttps://www.twitch.tv/videos/2931942986
latest_vod_datestring2026-11-18T01:45:09Z
channel_urlstringhttps://twitch.tv/twitch
errorslist[]
credits_usednumber2

4 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/social/twitch/channel" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"twitch"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/social/mastodon/post

One Mastodon post by its address: text, author, counts and date.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1275 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://mastodon.social/@Gargron/1
platformstringmastodon
extracted_atstring2026-11-18T20:36:20.693866+00:00
textstringHello world
titlestringHello world
author_namestringEugen Rochko
author_handlestringGargron
author_urlstringhttps://mastodon.social/@Gargron
author_avatarstringhttps://files.mastodon.social/accounts/avatars/000/000/001/original/6b2384b33799a0dd.png
author_followersnumber381410
author_verifiedbooleantrue
published_atstring2016-03-16T14:44:31.580Z
date_sourcestringmastodon_api
likesnumber1151
comments_countnumber66
repostsnumber605
imageslist[]
content_typestringpost
hashtagslist[]
mentionslist[]
extrasobject{"instance":"mastodon.social","status_id":"1","spoiler_text":"","sensitive":false,"visibility":"public","language":"en","media_attachments":[],"pol...
errorslist[]
credits_usednumber2

9 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/social/mastodon/post" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://mastodon.social/@Gargron/1"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/social/twitter/post

One post on X by its address: the headline text, date and author picture.

Price. 3 credits per call, which is 3,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1445 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://x.com/jack/status/20
platformstringtwitter
extracted_atstring2026-11-18T20:36:15.445035+00:00
titlestringjack (@jack) on X
descriptionstringjust setting up my twttr
published_atstring2006-03-21T20:50:14.000Z
date_sourcestringtwitter_og_meta
thumbnail_urlstringhttps://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_400x400.jpg
imageslist[]
content_typestringpost
hashtagslist[]
mentionslist[]
extrasobject{}
errorslist[]
credits_usednumber3

17 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/social/twitter/post" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/jack/status/20"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/visual/pinterest/pin

One Pinterest pin by its address: title, description and images.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1084 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://www.pinterest.com/pin/99360735500167749/
platformstringpinterest
extracted_atstring2026-11-18T20:36:55.402192+00:00
textstringHave you heard of Pinterest? Yes right? What about ? I just read the first report of live pinning on Mashable and I must say it is quite ...
titlestringNext stop: Pinterest!
descriptionstringHave you heard of Pinterest? Yes right? What about ? I just read the first report of live pinning on Mashable and I must say it is quite ...
author_namestringKent Brewster
author_urlstringhttps://www.pinterest.com/kentbrew/
date_sourcestringog_meta
thumbnail_urlstringhttps://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg
imageslist["https://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg"]
content_typestringpin
hashtagslist[]
mentionslist[]
extrasobject{"oembed":{"version":"1.0","type":"rich","provider_name":"Pinterest","provider_url":"https://www.pinterest.com","width":450,"height":436,"title":"N...
errorslist[]
credits_usednumber2

15 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/visual/pinterest/pin" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.pinterest.com/pin/99360735500167749/"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/social/bluesky/post

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 629 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d
platformstringbluesky
extracted_atstring2026-11-19T18:32:09.175507+00:00
textstringRead all about @germnetwork.com in @wired.com:
titlestringRead all about @germnetwork.com in @wired.com:
author_namestringBluesky
author_handlestringbsky.app
author_urlstringhttps://bsky.app/profile/bsky.app
author_avatarstringhttps://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka
published_atstring2026-11-18T21:57:26.111Z
date_sourcestringbluesky_atproto_api
likesnumber398
comments_countnumber18
sharesnumber1
repostsnumber30
imagesarray[]
content_typestringpost
hashtagsarray[]
mentionsarray[]
extrasobject{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","at_uri":"at://bsky.app/app.bsky.feed.post/3n2mkgfb4tk2d","cid":"bafyreif2sisjvqvshmnisis34mt6irs5ptxf3an...

10 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/social/bluesky/post" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/content/youtube/video

A YouTube video by address: title, channel name and address, and the thumbnail.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1188 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://www.youtube.com/watch?v=jNQXAC9IVRw
platformstringyoutube
extracted_atstring2026-11-19T18:38:23.548045+00:00
titlestringMe at the zoo
author_namestringjawed
author_urlstringhttps://www.youtube.com/@jawed
thumbnail_urlstringhttps://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg
imagesarray[]
content_typestringvideo
hashtagsarray[]
mentionsarray[]
extrasobject{"source":"youtube_oembed","note":"Title, channel and thumbnail only: YouTube did not serve the watch page to our network, so views, likes and the ...

18 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/content/youtube/video" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=jNQXAC9IVRw"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/content/youtube/channel

A YouTube channel by address: name, description, channel id and image.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1438 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
platformstringyoutube_channel
urlstringhttps://www.youtube.com/@YouTube
channel_namestringYouTube
descriptionstringYouTube's official YouTube channel
keywordsstringyoutube official channel
is_verifiedbooleanfalse
channel_idstringUCBR8-60-B28hp2BmDPdntcQ
thumbnailstringhttps://yt3.googleusercontent.com/LaXtRHwowjJqq8TZcqGx-QDFcFax_vz-5e8tgKaK0Un7Z2UX9lQfTdJixYP0go_A6XXmBC9l=s900-c-k-c0x00ffffff-no-rj

3 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/content/youtube/channel" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@YouTube"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/content/substack/post

A Substack post by address: title, description, the publication address and image.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1045 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://www.lennysnewsletter.com/p/how-to-build-product-sense
platformstringsubstack
extracted_atstring2026-11-19T18:38:28.043279+00:00
titlestringLenny's Newsletter | Substack
descriptionstringDeeply researched product, growth, and career advice for product leaders, founders, and ambitious builders. Click to read Lenny's Newsletter, a Sub...
author_urlstringhttps://www.lennysnewsletter.com
date_sourcestringog_meta
thumbnail_urlstringhttps://substackcdn.com/image/fetch/$s_!8MSN!,w_400,h_400,c_fill,f_auto,q_auto:good,fl_progressive:steep,g_auto/https%3A%2F%2Fsubstack-post-media.s...
imagesarray[]
content_typestringnewsletter_post
hashtagsarray[]
mentionsarray[]
extrasobject{"publication":"www.lennysnewsletter.com","subtitle":null,"paywall_type":"free","audio_url":null,"restacks":null,"word_count":null,"post_type":null...

17 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/content/substack/post" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.lennysnewsletter.com/p/how-to-build-product-sense"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/content/podcast/episode

A podcast page by address: title, description, the show's author and artwork.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1466 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://podcasts.apple.com/us/podcast/the-daily/id1200361736
platformstringpodcast
extracted_atstring2026-11-19T18:38:30.062202+00:00
titlestringThe Daily
descriptionstringDaily News Podcast · Updated Daily · This is what the news should sound like. The biggest stories of our time, told by the best journalists in the ...
author_namestringApple Podcasts
date_sourcestringog_meta
thumbnail_urlstringhttps://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/1200x1200bf-60.jpg
imagesarray[]
content_typestringpodcast_episode
hashtagsarray[]
mentionsarray[]
extrasobject{"duration":null,"episode_number":null,"season":null,"show_name":"Apple Podcasts","transcript_url":null}

17 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/content/podcast/episode" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://podcasts.apple.com/us/podcast/the-daily/id1200361736"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/talent/linkedin/job

A LinkedIn job posting by address: title, company and its page, location, posted-ago, applicant band, description and criteria (seniority, employment type, function, industries).

Price. 4 credits per call, which is 4,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1812 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstringhttps://www.linkedin.com/jobs/view/4472384142
platformstringlinkedin_jobs
extracted_atstring2026-11-19T18:55:54.232851+00:00
textstringAbout Scribe Scribe is where exceptional people come to do the best work of their careers. More than 94% of the Fortune 500 use Scribe to own their...
titlestringBackend Engineer
descriptionstringAbout Scribe Scribe is where exceptional people come to do the best work of their careers. More than 94% of the Fortune 500 use Scribe to own their...
author_namestringScribe
author_urlstringhttps://www.linkedin.com/company/scribehow
date_sourcestringlinkedin_guest_relative
thumbnail_urlstringhttps://media.licdn.com/dms/image/v2/D560BAQFOl0D6HTBe-A/company-logo_100_100/B56Z7WI87EG0AI-/0/1781709131682/scribehow_logo?e=2147483647&v=beta&t=...
imagesarray[]
content_typestringjob_posting
hashtagsarray[]
mentionsarray[]
extrasobject{"company":"Scribe","location":"San Francisco, CA","posted_ago":"1 week ago","applicants":"Over 200 applicants","job_id":"4472384142","criteria":{"...

15 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/talent/linkedin/job" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/jobs/view/4472384142"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


POST /v1/content/substack/publication

A newsletter home page by address: title, description, image and a note on what it returns.

Price. 2 credits per call, which is 2,000 credits per 1,000 calls. fact, catalog   Speed. One call on 19 November 2026 took 1877 ms. one observation

Fields filled in the real response (19 November 2026)

FieldTypeValue in that response
urlstring(text, not shown here)
platformstringsubstack_publication
extracted_atstring2026-11-19T23:05:50.983083+00:00
titlestringLenny's Newsletter | Substack
descriptionstring(text, not shown here)
thumbnail_urlstring(text, not shown here)
extrasobjectan object with 1 fields

23 other fields the response lists came back empty for this source and input, so they are not shown.

Request

curl -X POST "https://api.foxapis.com/v1/content/substack/publication" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.lennysnewsletter.com/"}'

Try it

The input below is the one behind the table above. The free demo runs it for you with no signup (a few runs per visitor).


Code in other languages

The request above is plain HTTP, so it works from any language. Ready-made samples in six languages are being added to the documentation.

The other data types

Company records · Developer profiles, repositories and posts · App store listings · Crypto coin and protocol data · Game, chess and music profiles · Online store catalog summary · Research papers, trials and approvals · People and company research · AI search visibility · Page and text utilities. All types, and what is not ready yet.

Source: live calls to https://api.foxapis.com on 19 November 2026, one call per endpoint with the documented sample input. Values reflect that moment and that input; a different input can leave different fields empty. Credits per call are the catalog's.

How we calculate

Data: the FoxAPIs catalog and plans, read 19 November 2026. Every other figure on this page is copied from the record, not calculated by us.

Run this free, then pay per call

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire. Use them at your own pace. Get my free key

One call costs 1 credit. That is $7.96 per 1,000 calls on the Production plan and $9.80 on Builder (plan price divided by its monthly credits). The Free plan gives 100 credits a month with no card.

Run this freeBuy credits

Building an AI agent?

See the MCP server