Fetchwire - Social Data
YouTube, TikTok, Instagram, X, Reddit, LinkedIn and Threads: public data in one schema.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~7,346Tokens (definiciones de herramientas)
~7.2 KBTamaño de respuesta típico
Impacto significativo en la atención (5.74% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"social-data": {
"url": "https://mcp.fetchwire.dev/mcp"
}
}
}Puntos de conexión remotos
https://mcp.fetchwire.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (10)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢get_user(platform, id)
A user's profile on any platform: follower counts, bio, verification, and platform extras under `extra`. Accepts a handle, id, or public URL. instagram: username or profile URL; for posts, a shortcode or /p/ or /reel/ URL. linkedin: profile slug or /in/ URL; for posts, an activity id or /posts/ URL. reddit: username, u/name, or profile URL; for posts, a t3_ id, bare id, or comments URL. threads: username, numeric user id, or profile URL; for posts, a shortcode or /post/ URL. tiktok: @handle, profile URL, or secUid; for posts, a video id or TikTok URL (short links included). x: screen name or profile URL; for posts, a tweet id or status URL. youtube: channel id (UC…), @handle, or channel URL; for posts, a video id or any YouTube URL.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"id": {
"description": "A handle, a platform id, or any public URL to the account or post. Parsed for you.",
"title": "Id",
"type": "string"
}
},
"required": [
"platform",
"id"
],
"title": "get_userArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author"
}🟢get_user_posts(platform, id, cursor)
A user's posts, newest first, with view, like, and comment counts. Pass the `next_cursor` from a previous response as `cursor` for the next page. instagram: username or profile URL; for posts, a shortcode or /p/ or /reel/ URL. reddit: username, u/name, or profile URL; for posts, a t3_ id, bare id, or comments URL. threads: username, numeric user id, or profile URL; for posts, a shortcode or /post/ URL. tiktok: @handle, profile URL, or secUid; for posts, a video id or TikTok URL (short links included). x: screen name or profile URL; for posts, a tweet id or status URL. youtube: channel id (UC…), @handle, or channel URL; for posts, a video id or any YouTube URL.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"id": {
"description": "A handle, a platform id, or any public URL to the account or post. Parsed for you.",
"title": "Id",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The `next_cursor` from a previous response. Omit for the first page.",
"title": "Cursor"
}
},
"required": [
"platform",
"id"
],
"title": "get_user_postsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "#/$defs/Post"
},
"title": "Items",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Opaque. Pass back as `cursor` to get the next page. Null when exhausted.",
"title": "Next Cursor"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total count when the platform reports one",
"title": "Total"
}
},
"required": [
"items"
],
"$defs": {
"Author": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author",
"type": "object"
},
"Post": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"type": {
"default": "video",
"enum": [
"video",
"short",
"live",
"image",
"text"
],
"title": "Type",
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Description or body text",
"title": "Text"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact publish time when the platform exposes it",
"title": "Created At"
},
"created_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Platform's relative text such as '7 days ago'",
"title": "Created At Text"
},
"duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Duration Seconds"
},
"stats": {
"$ref": "#/$defs/PostStats"
},
"thumbnails": {
"items": {
"$ref": "#/$defs/Thumbnail"
},
"title": "Thumbnails",
"type": "array"
},
"tags": {
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Language"
},
"is_live": {
"default": false,
"title": "Is Live",
"type": "boolean"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id",
"url"
],
"title": "Post",
"type": "object"
},
"PostStats": {
"properties": {
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"likes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Likes"
},
"comments": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Comments"
},
"shares": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Shares"
}
},
"title": "PostStats",
"type": "object"
},
"Thumbnail": {
"properties": {
"url": {
"title": "Url",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Width"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Height"
}
},
"required": [
"url"
],
"title": "Thumbnail",
"type": "object"
}
},
"title": "Page[Post]"
}🟢get_post(platform, id)
One post with its stats and author. Accepts a post id or any public URL. instagram: username or profile URL; for posts, a shortcode or /p/ or /reel/ URL. linkedin: profile slug or /in/ URL; for posts, an activity id or /posts/ URL. reddit: username, u/name, or profile URL; for posts, a t3_ id, bare id, or comments URL. threads: username, numeric user id, or profile URL; for posts, a shortcode or /post/ URL. tiktok: @handle, profile URL, or secUid; for posts, a video id or TikTok URL (short links included). x: screen name or profile URL; for posts, a tweet id or status URL. youtube: channel id (UC…), @handle, or channel URL; for posts, a video id or any YouTube URL.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"id": {
"description": "A handle, a platform id, or any public URL to the account or post. Parsed for you.",
"title": "Id",
"type": "string"
}
},
"required": [
"platform",
"id"
],
"title": "get_postArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"type": {
"default": "video",
"enum": [
"video",
"short",
"live",
"image",
"text"
],
"title": "Type",
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Description or body text",
"title": "Text"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact publish time when the platform exposes it",
"title": "Created At"
},
"created_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Platform's relative text such as '7 days ago'",
"title": "Created At Text"
},
"duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Duration Seconds"
},
"stats": {
"$ref": "#/$defs/PostStats"
},
"thumbnails": {
"items": {
"$ref": "#/$defs/Thumbnail"
},
"title": "Thumbnails",
"type": "array"
},
"tags": {
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Language"
},
"is_live": {
"default": false,
"title": "Is Live",
"type": "boolean"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id",
"url"
],
"$defs": {
"Author": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author",
"type": "object"
},
"PostStats": {
"properties": {
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"likes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Likes"
},
"comments": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Comments"
},
"shares": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Shares"
}
},
"title": "PostStats",
"type": "object"
},
"Thumbnail": {
"properties": {
"url": {
"title": "Url",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Width"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Height"
}
},
"required": [
"url"
],
"title": "Thumbnail",
"type": "object"
}
},
"title": "Post"
}🟢get_comments(platform, id, cursor)
Comments on a post, flat, with `parent_id` set on replies so the tree is one pass to rebuild. A comment's `replies_cursor` passed as `cursor` returns that thread. instagram: username or profile URL; for posts, a shortcode or /p/ or /reel/ URL. reddit: username, u/name, or profile URL; for posts, a t3_ id, bare id, or comments URL. threads: username, numeric user id, or profile URL; for posts, a shortcode or /post/ URL. tiktok: @handle, profile URL, or secUid; for posts, a video id or TikTok URL (short links included). x: screen name or profile URL; for posts, a tweet id or status URL. youtube: channel id (UC…), @handle, or channel URL; for posts, a video id or any YouTube URL.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"id": {
"description": "A handle, a platform id, or any public URL to the account or post. Parsed for you.",
"title": "Id",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The `next_cursor` from a previous response. Omit for the first page.",
"title": "Cursor"
}
},
"required": [
"platform",
"id"
],
"title": "get_commentsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "#/$defs/Comment"
},
"title": "Items",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Opaque. Pass back as `cursor` to get the next page. Null when exhausted.",
"title": "Next Cursor"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total count when the platform reports one",
"title": "Total"
}
},
"required": [
"items"
],
"$defs": {
"Author": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author",
"type": "object"
},
"Comment": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"post_id": {
"title": "Post Id",
"type": "string"
},
"parent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent Id"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"text": {
"title": "Text",
"type": "string"
},
"created_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At Text"
},
"likes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Likes"
},
"reply_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Reply Count"
},
"pinned": {
"default": false,
"title": "Pinned",
"type": "boolean"
},
"by_creator": {
"default": false,
"title": "By Creator",
"type": "boolean"
},
"replies_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to the comments endpoint as `cursor` to fetch replies",
"title": "Replies Cursor"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id",
"post_id",
"text"
],
"title": "Comment",
"type": "object"
}
},
"title": "Page[Comment]"
}🟢search_posts(platform, q, sort, cursor)
Search posts or videos by keyword on youtube, tiktok, instagram, x, or reddit. `sort` varies by platform — omit it for the default. LinkedIn and Threads have no keyword search; use list_routes to see what they do offer.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"q": {
"description": "The search text, as a person would type it.",
"title": "Q",
"type": "string"
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Platform-specific ordering. Omit for the platform's default.",
"title": "Sort"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The `next_cursor` from a previous response. Omit for the first page.",
"title": "Cursor"
}
},
"required": [
"platform",
"q"
],
"title": "search_postsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "#/$defs/Post"
},
"title": "Items",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Opaque. Pass back as `cursor` to get the next page. Null when exhausted.",
"title": "Next Cursor"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total count when the platform reports one",
"title": "Total"
}
},
"required": [
"items"
],
"$defs": {
"Author": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author",
"type": "object"
},
"Post": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"type": {
"default": "video",
"enum": [
"video",
"short",
"live",
"image",
"text"
],
"title": "Type",
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Description or body text",
"title": "Text"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact publish time when the platform exposes it",
"title": "Created At"
},
"created_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Platform's relative text such as '7 days ago'",
"title": "Created At Text"
},
"duration_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Duration Seconds"
},
"stats": {
"$ref": "#/$defs/PostStats"
},
"thumbnails": {
"items": {
"$ref": "#/$defs/Thumbnail"
},
"title": "Thumbnails",
"type": "array"
},
"tags": {
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Language"
},
"is_live": {
"default": false,
"title": "Is Live",
"type": "boolean"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id",
"url"
],
"title": "Post",
"type": "object"
},
"PostStats": {
"properties": {
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"likes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Likes"
},
"comments": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Comments"
},
"shares": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Shares"
}
},
"title": "PostStats",
"type": "object"
},
"Thumbnail": {
"properties": {
"url": {
"title": "Url",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Width"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Height"
}
},
"required": [
"url"
],
"title": "Thumbnail",
"type": "object"
}
},
"title": "Page[Post]"
}🟢search_users(platform, q, cursor)
Find accounts by name or keyword on youtube, tiktok, instagram, x, reddit, or threads. Useful for turning a person or brand name into the handle the other tools take. LinkedIn has no profile search.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"description": "One of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform",
"type": "string"
},
"q": {
"description": "The search text, as a person would type it.",
"title": "Q",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The `next_cursor` from a previous response. Omit for the first page.",
"title": "Cursor"
}
},
"required": [
"platform",
"q"
],
"title": "search_usersArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "#/$defs/Author"
},
"title": "Items",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Opaque. Pass back as `cursor` to get the next page. Null when exhausted.",
"title": "Next Cursor"
},
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total count when the platform reports one",
"title": "Total"
}
},
"required": [
"items"
],
"$defs": {
"Author": {
"properties": {
"platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"x",
"reddit",
"linkedin",
"threads"
],
"title": "Platform",
"type": "string"
},
"id": {
"title": "Id",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"followers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Subscribers on YouTube. Approximate unless exact is available.",
"title": "Followers"
},
"posts_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posts Count"
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Views"
},
"joined_at_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Joined At Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"extra": {
"additionalProperties": true,
"title": "Extra",
"type": "object"
}
},
"required": [
"platform",
"id"
],
"title": "Author",
"type": "object"
}
},
"title": "Page[Author]"
}🟢list_routes(platform, contains)
Every route Fetchwire serves, with what each costs in credits. Free to call. Use it to find the routes the operation tools do not cover — TikTok's shop, live, and trending data, Reddit's subreddits and feeds, LinkedIn's jobs, Instagram's hashtags and places, X's communities and lists — then fetch one with call_route. Filter by `platform`, or by `contains` to match on the path.
Esquema de entrada
{
"type": "object",
"properties": {
"platform": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Narrow to one of: youtube, tiktok, instagram, x, reddit, linkedin, threads.",
"title": "Platform"
},
"contains": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Match on the path, e.g. 'shop' or 'transcript'.",
"title": "Contains"
}
},
"title": "list_routesArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"count": {
"title": "Count",
"type": "integer"
},
"routes": {
"items": {
"$ref": "#/$defs/RouteInfo"
},
"title": "Routes",
"type": "array"
},
"note": {
"title": "Note",
"type": "string"
}
},
"required": [
"count",
"routes",
"note"
],
"$defs": {
"RouteInfo": {
"properties": {
"path": {
"description": "Pass to call_route.",
"title": "Path",
"type": "string"
},
"credits": {
"description": "What one uncached call costs.",
"title": "Credits",
"type": "integer"
}
},
"required": [
"path",
"credits"
],
"title": "RouteInfo",
"type": "object"
}
},
"title": "RouteList"
}🟢call_route(path, params)
Fetch any Fetchwire route by path, for the routes the operation tools do not cover. Find the path with list_routes first. `params` are the query parameters, e.g. call_route('/v1/tiktok/hashtag/videos', {'id': 'space'}). Spends credits like any other call.
Esquema de entrada
{
"type": "object",
"properties": {
"path": {
"description": "A path from list_routes, starting with /v1/.",
"title": "Path",
"type": "string"
},
"params": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Query parameters for that route, e.g. {'id': 'space'}.",
"title": "Params"
}
},
"required": [
"path"
],
"title": "call_routeArguments"
}🟢get_usage
The calling key's credit balance and this month's usage by endpoint. Free to call.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "get_usageArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"key_name": {
"title": "Key Name",
"type": "string"
},
"period": {
"title": "Period",
"type": "string"
},
"credits_used": {
"description": "This month, across all keys of the same account",
"title": "Credits Used",
"type": "integer"
},
"balance": {
"description": "Prepaid credits left on the account. Credits never expire.",
"title": "Balance",
"type": "integer"
},
"credits_remaining": {
"description": "Same as balance, kept for older clients",
"title": "Credits Remaining",
"type": "integer"
},
"by_endpoint": {
"items": {
"$ref": "#/$defs/EndpointUsage"
},
"title": "By Endpoint",
"type": "array"
}
},
"required": [
"key_name",
"period",
"credits_used",
"balance",
"credits_remaining",
"by_endpoint"
],
"$defs": {
"EndpointUsage": {
"properties": {
"endpoint": {
"title": "Endpoint",
"type": "string"
},
"requests": {
"title": "Requests",
"type": "integer"
},
"credits": {
"title": "Credits",
"type": "integer"
},
"cache_hits": {
"title": "Cache Hits",
"type": "integer"
}
},
"required": [
"endpoint",
"requests",
"credits",
"cache_hits"
],
"title": "EndpointUsage",
"type": "object"
}
},
"title": "Usage"
}🟢list_platforms
The platforms Fetchwire serves and which of the six operations each one supports.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "list_platformsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"platforms": {
"items": {
"$ref": "#/$defs/PlatformOps"
},
"title": "Platforms",
"type": "array"
},
"note": {
"title": "Note",
"type": "string"
}
},
"required": [
"platforms",
"note"
],
"$defs": {
"PlatformOps": {
"properties": {
"platform": {
"title": "Platform",
"type": "string"
},
"operations": {
"description": "Which of the six operation tools this platform serves.",
"items": {
"type": "string"
},
"title": "Operations",
"type": "array"
}
},
"required": [
"platform",
"operations"
],
"title": "PlatformOps",
"type": "object"
}
},
"title": "PlatformList"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada10 herramientas
verificadoversión no registrada10 herramientas