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
| Endpoint | What it returns | Credits per call | Credits per 1,000 calls |
|---|---|---|---|
POST /v1/social/twitch/channel | A Twitch channel by name: followers, partner status, whether it is live and its latest video. | 2 | 2,000 |
POST /v1/social/mastodon/post | One Mastodon post by its address: text, author, counts and date. | 2 | 2,000 |
POST /v1/social/twitter/post | One post on X by its address: the headline text, date and author picture. | 3 | 3,000 |
POST /v1/visual/pinterest/pin | One Pinterest pin by its address: title, description and images. | 2 | 2,000 |
POST /v1/social/bluesky/post | 2 | 2,000 | |
POST /v1/content/youtube/video | A YouTube video by address: title, channel name and address, and the thumbnail. | 2 | 2,000 |
POST /v1/content/youtube/channel | A YouTube channel by address: name, description, channel id and image. | 2 | 2,000 |
POST /v1/content/substack/post | A Substack post by address: title, description, the publication address and image. | 2 | 2,000 |
POST /v1/content/podcast/episode | A podcast page by address: title, description, the show's author and artwork. | 2 | 2,000 |
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). | 4 | 4,000 |
POST /v1/content/substack/publication | A newsletter home page by address: title, description, image and a note on what it returns. | 2 | 2,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.
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)
| Field | Type | Value in that response |
|---|---|---|
platform | string | twitch |
login | string | twitch |
display_name | string | Twitch |
broadcaster_type | string | partner |
description | string | Twitch is where thousands of communities come together for whatever, every day. |
profile_image_url | string | https://static-cdn.jtvnw.net/jtv_user_pictures/e437c251-ced5-476f-b3c6-fd6686c51550-profile_image-300x300.png |
account_created | string | 2007-05-22T10:39:54Z |
total_views | number | 0 |
followers | number | 2506487 |
is_live | boolean | false |
latest_vod_title | string | GTAVI Countdown |
latest_vod_url | string | https://www.twitch.tv/videos/2931942986 |
latest_vod_date | string | 2026-11-18T01:45:09Z |
channel_url | string | https://twitch.tv/twitch |
errors | list | [] |
credits_used | number | 2 |
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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://mastodon.social/@Gargron/1 |
platform | string | mastodon |
extracted_at | string | 2026-11-18T20:36:20.693866+00:00 |
text | string | Hello world |
title | string | Hello world |
author_name | string | Eugen Rochko |
author_handle | string | Gargron |
author_url | string | https://mastodon.social/@Gargron |
author_avatar | string | https://files.mastodon.social/accounts/avatars/000/000/001/original/6b2384b33799a0dd.png |
author_followers | number | 381410 |
author_verified | boolean | true |
published_at | string | 2016-03-16T14:44:31.580Z |
date_source | string | mastodon_api |
likes | number | 1151 |
comments_count | number | 66 |
reposts | number | 605 |
images | list | [] |
content_type | string | post |
hashtags | list | [] |
mentions | list | [] |
extras | object | {"instance":"mastodon.social","status_id":"1","spoiler_text":"","sensitive":false,"visibility":"public","language":"en","media_attachments":[],"pol... |
errors | list | [] |
credits_used | number | 2 |
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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://x.com/jack/status/20 |
platform | string | |
extracted_at | string | 2026-11-18T20:36:15.445035+00:00 |
title | string | jack (@jack) on X |
description | string | just setting up my twttr |
published_at | string | 2006-03-21T20:50:14.000Z |
date_source | string | twitter_og_meta |
thumbnail_url | string | https://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_400x400.jpg |
images | list | [] |
content_type | string | post |
hashtags | list | [] |
mentions | list | [] |
extras | object | {} |
errors | list | [] |
credits_used | number | 3 |
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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://www.pinterest.com/pin/99360735500167749/ |
platform | string | |
extracted_at | string | 2026-11-18T20:36:55.402192+00:00 |
text | string | Have 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 ... |
title | string | Next stop: Pinterest! |
description | string | Have 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_name | string | Kent Brewster |
author_url | string | https://www.pinterest.com/kentbrew/ |
date_source | string | og_meta |
thumbnail_url | string | https://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg |
images | list | ["https://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg"] |
content_type | string | pin |
hashtags | list | [] |
mentions | list | [] |
extras | object | {"oembed":{"version":"1.0","type":"rich","provider_name":"Pinterest","provider_url":"https://www.pinterest.com","width":450,"height":436,"title":"N... |
errors | list | [] |
credits_used | number | 2 |
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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d |
platform | string | bluesky |
extracted_at | string | 2026-11-19T18:32:09.175507+00:00 |
text | string | Read all about @germnetwork.com in @wired.com: |
title | string | Read all about @germnetwork.com in @wired.com: |
author_name | string | Bluesky |
author_handle | string | bsky.app |
author_url | string | https://bsky.app/profile/bsky.app |
author_avatar | string | https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka |
published_at | string | 2026-11-18T21:57:26.111Z |
date_source | string | bluesky_atproto_api |
likes | number | 398 |
comments_count | number | 18 |
shares | number | 1 |
reposts | number | 30 |
images | array | [] |
content_type | string | post |
hashtags | array | [] |
mentions | array | [] |
extras | object | {"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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://www.youtube.com/watch?v=jNQXAC9IVRw |
platform | string | youtube |
extracted_at | string | 2026-11-19T18:38:23.548045+00:00 |
title | string | Me at the zoo |
author_name | string | jawed |
author_url | string | https://www.youtube.com/@jawed |
thumbnail_url | string | https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg |
images | array | [] |
content_type | string | video |
hashtags | array | [] |
mentions | array | [] |
extras | object | {"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)
| Field | Type | Value in that response |
|---|---|---|
platform | string | youtube_channel |
url | string | https://www.youtube.com/@YouTube |
channel_name | string | YouTube |
description | string | YouTube's official YouTube channel |
keywords | string | youtube official channel |
is_verified | boolean | false |
channel_id | string | UCBR8-60-B28hp2BmDPdntcQ |
thumbnail | string | https://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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://www.lennysnewsletter.com/p/how-to-build-product-sense |
platform | string | substack |
extracted_at | string | 2026-11-19T18:38:28.043279+00:00 |
title | string | Lenny's Newsletter | Substack |
description | string | Deeply researched product, growth, and career advice for product leaders, founders, and ambitious builders. Click to read Lenny's Newsletter, a Sub... |
author_url | string | https://www.lennysnewsletter.com |
date_source | string | og_meta |
thumbnail_url | string | https://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... |
images | array | [] |
content_type | string | newsletter_post |
hashtags | array | [] |
mentions | array | [] |
extras | object | {"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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://podcasts.apple.com/us/podcast/the-daily/id1200361736 |
platform | string | podcast |
extracted_at | string | 2026-11-19T18:38:30.062202+00:00 |
title | string | The Daily |
description | string | Daily 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_name | string | Apple Podcasts |
date_source | string | og_meta |
thumbnail_url | string | https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/1200x1200bf-60.jpg |
images | array | [] |
content_type | string | podcast_episode |
hashtags | array | [] |
mentions | array | [] |
extras | object | {"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)
| Field | Type | Value in that response |
|---|---|---|
url | string | https://www.linkedin.com/jobs/view/4472384142 |
platform | string | linkedin_jobs |
extracted_at | string | 2026-11-19T18:55:54.232851+00:00 |
text | string | About 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... |
title | string | Backend Engineer |
description | string | About 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_name | string | Scribe |
author_url | string | https://www.linkedin.com/company/scribehow |
date_source | string | linkedin_guest_relative |
thumbnail_url | string | https://media.licdn.com/dms/image/v2/D560BAQFOl0D6HTBe-A/company-logo_100_100/B56Z7WI87EG0AI-/0/1781709131682/scribehow_logo?e=2147483647&v=beta&t=... |
images | array | [] |
content_type | string | job_posting |
hashtags | array | [] |
mentions | array | [] |
extras | object | {"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)
| Field | Type | Value in that response |
|---|---|---|
url | string | (text, not shown here) |
platform | string | substack_publication |
extracted_at | string | 2026-11-19T23:05:50.983083+00:00 |
title | string | Lenny's Newsletter | Substack |
description | string | (text, not shown here) |
thumbnail_url | string | (text, not shown here) |
extras | object | an 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
- Cost for your calls: The credits per call from the catalog times the calls you type, and the smallest plan whose monthly credits cover that number.
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.
Building an AI agent?
- The FoxAPIs MCP server gives your agent every tool through one connection.
- Per-call pricing in credits: you pay for the calls your agent makes, with no seats.
- Free plan: 100 credits a month, no card, no monthly fee.