{"components":{"schemas":{"Error":{"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"LookupMeta":{"properties":{"credits_charged":{"type":"integer"},"latency_ms":{"type":"integer"},"path":{"type":"string"},"platform":{"type":"string"},"resource":{"type":"string"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"bearerFormat":"API key","description":"Dashboard API key. Example: Authorization: Bearer sk_live_...","scheme":"bearer","type":"http"}}},"info":{"contact":{"name":"Socify","url":"https://trysocify.com"},"description":"Social data API. Authenticate with a Bearer API key from the dashboard. Each successful lookup consumes credits.","title":"Socify API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/health":{"get":{"operationId":"health","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"example":"true","type":"string"}},"type":"object"}}},"description":"Service is up"}},"security":[{}],"summary":"Health check","tags":["Meta"]}},"/api/v1/catalog":{"get":{"description":"Returns the live route catalog used by docs and clients.","operationId":"getCatalog","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"mode":{"example":"live","type":"string"},"platforms":{"items":{"type":"object"},"type":"array"}},"type":"object"}}},"description":"Catalog of platforms and endpoints"}},"security":[{}],"summary":"List platforms and endpoints","tags":["Meta"]}},"/api/v1/instagram/comments":{"get":{"description":"Fetch public comments for a post. Provide code, id, or url. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_comments","parameters":[{"description":"Post shortcode, id, or url (provide one).","in":"query","name":"code","required":false,"schema":{"example":"C-6WRvdS75Q","type":"string"}},{"description":"Numeric media id (alternative to code/url).","in":"query","name":"id","required":false,"schema":{"example":"3439159241662512720","type":"string"}},{"description":"Full Instagram post URL (alternative to code/id).","in":"query","name":"url","required":false,"schema":{"example":"https://www.instagram.com/p/C-6WRvdS75Q/","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"author":{"id":"64490093540","username":"photo_fan","verified":false},"created_at":1754086530,"id":"18079390237903009","likes":42,"text":"Incredible shot!"}],"cursor":"QVFEZC01eGxyeUlfUXFfRU5VNHNJcFlF..."},"ok":true},"schema":{"properties":{"data":{"properties":{"comments":{"description":"Comments for this page.","type":"array"},"comments[].author":{"description":"Author username, id, verified.","type":"object"},"comments[].created_at":{"description":"Unix timestamp.","type":"number"},"comments[].id":{"description":"Comment id.","type":"string"},"comments[].likes":{"description":"Like count.","type":"number"},"comments[].text":{"description":"Comment text.","type":"string"},"cursor":{"description":"Pass as cursor for the next page.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Comments","tags":["Instagram"]}},"/api/v1/instagram/followers":{"get":{"description":"Fetch a page of followers for a profile. Provide username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_followers","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFDY2ZDeG1pY01YenVvazR0bVBkQnZhVmhE...","users":[{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","id":"64490093540","name":"Photo Fan","username":"photo_fan","verified":false}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Follower profiles for this page.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Followers","tags":["Instagram"]}},"/api/v1/instagram/following":{"get":{"description":"Fetch a page of accounts a profile follows. Provide username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_following","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFDY2ZDeG1pY01YenVvazR0bVBkQnZhVmhE...","users":[{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","id":"25025320","name":"Instagram","username":"instagram","verified":true}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Following profiles for this page.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Following","tags":["Instagram"]}},"/api/v1/instagram/hashtag":{"get":{"description":"Fetch public metadata for an Instagram hashtag. Costs 1 credit per request.","operationId":"instagram_hashtag","parameters":[{"description":"Hashtag name without #.","in":"query","name":"name","required":true,"schema":{"example":"nature","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"id":"17843851942029952","name":"nature","posts":512000000},"ok":true},"schema":{"properties":{"data":{"properties":{"id":{"description":"Hashtag id.","type":"string"},"name":{"description":"Hashtag name.","type":"string"},"posts":{"description":"Media count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Hashtag","tags":["Instagram"]}},"/api/v1/instagram/hashtag-posts":{"get":{"description":"Fetch top public posts for a hashtag. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_hashtag_posts","parameters":[{"description":"Hashtag name without #.","in":"query","name":"name","required":true,"schema":{"example":"nature","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFEM0xYb2...","posts":[{"author":{"id":"9129067435","username":"wildlife_daily"},"caption":"Golden hour in the wild.","code":"C-6WRvdS75Q","comments":812,"created_at":1724199751,"id":"3439159241662512720","likes":98400,"thumbnail":"https://scontent.cdninstagram.com/v/t51.29350-15/example.jpg","type":"image","url":"https://www.instagram.com/p/C-6WRvdS75Q/"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"posts":{"description":"Posts for this page.","type":"array"},"posts[].caption":{"description":"Caption text.","type":"string"},"posts[].code":{"description":"Shortcode.","type":"string"},"posts[].id":{"description":"Media id.","type":"string"},"posts[].likes":{"description":"Like count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Hashtag Posts","tags":["Instagram"]}},"/api/v1/instagram/highlights":{"get":{"description":"Fetch story highlights for a username. Costs 1 credit per request.","operationId":"instagram_highlights","parameters":[{"description":"Instagram username without @.","in":"query","name":"username","required":true,"schema":{"example":"natgeo","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"highlights":[{"count":12,"cover":"https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg","id":"17843851942029952","title":"Wildlife"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"highlights":{"description":"Highlight trays.","type":"array"},"highlights[].count":{"description":"Item count, when available.","type":"number"},"highlights[].cover":{"description":"Cover image URL.","type":"string"},"highlights[].id":{"description":"Highlight id.","type":"string"},"highlights[].title":{"description":"Highlight title.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Highlights","tags":["Instagram"]}},"/api/v1/instagram/likers":{"get":{"description":"Fetch users who liked a post. Provide code, id, or url. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_likers","parameters":[{"description":"Post shortcode, id, or url (provide one).","in":"query","name":"code","required":false,"schema":{"example":"C-6WRvdS75Q","type":"string"}},{"description":"Numeric media id (alternative to code/url).","in":"query","name":"id","required":false,"schema":{"example":"3439159241662512720","type":"string"}},{"description":"Full Instagram post URL (alternative to code/id).","in":"query","name":"url","required":false,"schema":{"example":"https://www.instagram.com/p/C-6WRvdS75Q/","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFE...","users":[{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","id":"64490093540","name":"Photo Fan","username":"photo_fan","verified":false}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Users who liked the post.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Likers","tags":["Instagram"]}},"/api/v1/instagram/post":{"get":{"description":"Fetch public details for a single post. Provide code or url. Costs 1 credit per request.","operationId":"instagram_post","parameters":[{"description":"Post shortcode or url (provide one).","in":"query","name":"code","required":false,"schema":{"example":"C-6WRvdS75Q","type":"string"}},{"description":"Full Instagram post URL (alternative to code).","in":"query","name":"url","required":false,"schema":{"example":"https://www.instagram.com/p/C-6WRvdS75Q/","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"author":{"id":"787132","username":"natgeo"},"caption":"A lion rests on the savanna.","code":"C-6WRvdS75Q","comments":4653,"created_at":1664367775,"id":"2937252247889807569","likes":642848,"thumbnail":"https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg","type":"image","url":"https://www.instagram.com/p/C-6WRvdS75Q/","video_url":"","views":0},"ok":true},"schema":{"properties":{"data":{"properties":{"author":{"description":"Author username and id.","type":"object"},"caption":{"description":"Caption text.","type":"string"},"code":{"description":"Shortcode.","type":"string"},"comments":{"description":"Comment count.","type":"number"},"created_at":{"description":"Unix publish timestamp.","type":"number"},"id":{"description":"Media id.","type":"string"},"likes":{"description":"Like count.","type":"number"},"thumbnail":{"description":"Thumbnail URL.","type":"string"},"type":{"description":"image, video, or carousel.","type":"string"},"url":{"description":"Post URL.","type":"string"},"video_url":{"description":"Video URL, when available.","type":"string"},"views":{"description":"View/play count, when available.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Post","tags":["Instagram"]}},"/api/v1/instagram/posts":{"get":{"description":"Fetch recent public posts for a profile. Provide username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_posts","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFENkVvdWUzN2ZGbjNGX0RVcU9ZMWxr...","posts":[{"author":{"id":"787132","username":"natgeo"},"caption":"A lion rests on the savanna.","code":"C-6WRvdS75Q","comments":4653,"created_at":1724199751,"id":"3439159241662512720","likes":642848,"thumbnail":"https://scontent.cdninstagram.com/v/t51.29350-15/example.jpg","type":"image","url":"https://www.instagram.com/p/C-6WRvdS75Q/","video_url":"","views":0}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"posts":{"description":"Posts for this page.","type":"array"},"posts[].author":{"description":"Author username and id.","type":"object"},"posts[].caption":{"description":"Caption text.","type":"string"},"posts[].code":{"description":"Shortcode.","type":"string"},"posts[].comments":{"description":"Comment count.","type":"number"},"posts[].created_at":{"description":"Unix publish timestamp.","type":"number"},"posts[].id":{"description":"Media id.","type":"string"},"posts[].likes":{"description":"Like count.","type":"number"},"posts[].thumbnail":{"description":"Thumbnail URL.","type":"string"},"posts[].type":{"description":"image, video, or carousel.","type":"string"},"posts[].url":{"description":"Post URL.","type":"string"},"posts[].video_url":{"description":"Video URL, when available.","type":"string"},"posts[].views":{"description":"View/play count, when available.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Posts","tags":["Instagram"]}},"/api/v1/instagram/profile":{"get":{"description":"Fetch a public Instagram profile by username: bio, counts, avatar, and verification. Costs 1 credit per request.","operationId":"instagram_profile","parameters":[{"description":"Instagram username without @.","in":"query","name":"username","required":true,"schema":{"example":"natgeo","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","bio":"Step into wonder and find your inner explorer with National Geographic 🌎","category":"","followers":268308300,"following":195,"id":"787132","name":"National Geographic","posts":32105,"private":false,"url":"https://instagram.com/natgeo","username":"natgeo","verified":true,"website":"http://visitstore.bio/natgeo"},"ok":true},"schema":{"properties":{"data":{"properties":{"avatar":{"description":"Profile picture URL.","type":"string"},"bio":{"description":"Profile bio.","type":"string"},"category":{"description":"Category label, when set.","type":"string"},"followers":{"description":"Follower count.","type":"number"},"following":{"description":"Following count.","type":"number"},"id":{"description":"User id.","type":"string"},"name":{"description":"Display name.","type":"string"},"posts":{"description":"Post count.","type":"number"},"private":{"description":"Whether private.","type":"boolean"},"url":{"description":"Profile URL.","type":"string"},"username":{"description":"Username.","type":"string"},"verified":{"description":"Whether verified.","type":"boolean"},"website":{"description":"External website, when set.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Profile","tags":["Instagram"]}},"/api/v1/instagram/reels":{"get":{"description":"Fetch recent reels for a profile. Provide username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_reels","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFCSFFDSnV5dTVsYk1BSTJCNndoUXlCZ1kz...","reels":[{"author":{"id":"787132","username":"natgeo"},"caption":"Behind the scenes in the field.","code":"ClB4ZlQJlDs","comments":631,"created_at":1668621756,"id":"2972905277632172268","likes":120450,"thumbnail":"https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg","type":"video","url":"https://www.instagram.com/reel/ClB4ZlQJlDs/","video_url":"https://scontent.cdninstagram.com/v/t50.2886-16/example.mp4","views":2450000}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"reels":{"description":"Reels for this page.","type":"array"},"reels[].author":{"description":"Author username and id.","type":"object"},"reels[].caption":{"description":"Caption text.","type":"string"},"reels[].code":{"description":"Shortcode.","type":"string"},"reels[].comments":{"description":"Comment count.","type":"number"},"reels[].created_at":{"description":"Unix publish timestamp.","type":"number"},"reels[].id":{"description":"Media id.","type":"string"},"reels[].likes":{"description":"Like count.","type":"number"},"reels[].thumbnail":{"description":"Thumbnail URL.","type":"string"},"reels[].type":{"description":"Usually video.","type":"string"},"reels[].url":{"description":"Reel URL.","type":"string"},"reels[].video_url":{"description":"Video URL, when available.","type":"string"},"reels[].views":{"description":"Play count, when available.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Reels","tags":["Instagram"]}},"/api/v1/instagram/related":{"get":{"description":"Fetch suggested/related profiles for a username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_related","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"","users":[{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","id":"18428658","name":"National Geographic Travel","username":"natgeotravel","verified":true}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page, when available.","type":"string"},"users":{"description":"Related profiles.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Related","tags":["Instagram"]}},"/api/v1/instagram/search":{"get":{"description":"Search public Instagram users by query. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_search","parameters":[{"description":"Search text.","in":"query","name":"query","required":true,"schema":{"example":"natgeo","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"","users":[{"avatar":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","id":"787132","name":"National Geographic","username":"natgeo","verified":true}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page, when available.","type":"string"},"users":{"description":"Matching users.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Search","tags":["Instagram"]}},"/api/v1/instagram/stories":{"get":{"description":"Fetch current public stories for a username. Costs 1 credit per request.","operationId":"instagram_stories","parameters":[{"description":"Instagram username without @.","in":"query","name":"username","required":true,"schema":{"example":"natgeo","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"stories":[{"created_at":1724200000,"id":"3407843880258348330","thumbnail":"https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg","type":"video","video_url":"https://scontent.cdninstagram.com/v/t50.2886-16/example.mp4"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"stories":{"description":"Active story items.","type":"array"},"stories[].created_at":{"description":"Unix timestamp.","type":"number"},"stories[].id":{"description":"Story media id.","type":"string"},"stories[].thumbnail":{"description":"Thumbnail URL.","type":"string"},"stories[].type":{"description":"image or video.","type":"string"},"stories[].video_url":{"description":"Video URL, when available.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Stories","tags":["Instagram"]}},"/api/v1/instagram/tagged":{"get":{"description":"Fetch public posts where a profile was tagged. Provide username or user_id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"instagram_tagged","parameters":[{"description":"Username or user_id (provide one).","in":"query","name":"username","required":false,"schema":{"example":"natgeo","type":"string"}},{"description":"Numeric user id (alternative to username).","in":"query","name":"user_id","required":false,"schema":{"example":"787132","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"QVFDY2ZDeG1pY01YenVvazR0bVBkQnZhVmhE...","posts":[{"author":{"id":"9129067435","username":"wildlife_photographer"},"caption":"Collab shoot.","code":"CofSzxwIgdq","comments":13,"created_at":1676047570,"id":"3035227396822402922","likes":49,"thumbnail":"https://scontent.cdninstagram.com/v/t51.2885-15/example.jpg","type":"video","url":"https://www.instagram.com/p/CofSzxwIgdq/","views":25910}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"posts":{"description":"Tagged posts for this page.","type":"array"},"posts[].author":{"description":"Post owner.","type":"object"},"posts[].code":{"description":"Shortcode.","type":"string"},"posts[].id":{"description":"Media id.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Tagged","tags":["Instagram"]}},"/api/v1/linkedin/company":{"get":{"description":"Fetch a public LinkedIn company page by URL: about, size, industry, and followers. Costs 3 credits per request.","operationId":"linkedin_company_info","parameters":[{"description":"LinkedIn company URL.","in":"query","name":"url","required":true,"schema":{"example":"https://il.linkedin.com/company/ibm","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"about":"AI-first work platform for video, chat, and more.","company_id":"2532259","company_size":"5,001-10,000 employees","followers":653039,"founded":2013,"headquarters":"San Jose, CA","industries":"IT Services and IT Consulting","logo":"https://media.licdn.com/dms/image/example_logo","name":"Zoom","website":"https://www.zoom.com/"},"ok":true},"schema":{"properties":{"data":{"properties":{"about":{"description":"About text.","type":"string"},"company_size":{"description":"Employee size band.","type":"string"},"followers":{"description":"Follower count.","type":"number"},"headquarters":{"description":"HQ location.","type":"string"},"industries":{"description":"Industry label.","type":"string"},"logo":{"description":"Logo URL.","type":"string"},"name":{"description":"Company name.","type":"string"},"website":{"description":"Company website.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"LinkedIn Company","tags":["LinkedIn"]}},"/api/v1/linkedin/company-posts":{"get":{"description":"Discover recent public posts from a LinkedIn company page URL: text, engagement, and author metadata. Costs 5 credits per request.","operationId":"linkedin_company_posts","parameters":[{"description":"LinkedIn company URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.linkedin.com/company/microsoft","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"account_type":"Organization","date_posted":"2026-03-17T10:30:06.724Z","hashtags":["#AI","#Microsoft"],"id":"7439619065922625537","num_comments":96,"num_likes":1284,"post_text":"Excited to share our latest product updates for enterprise teams.","post_type":"post","url":"https://www.linkedin.com/posts/microsoft_activity-7439619065922625537","user_followers":23000000,"user_id":"microsoft"}],"ok":true},"schema":{"properties":{"data":{"properties":{"account_type":{"description":"Author account type (e.g. Organization).","type":"string"},"date_posted":{"description":"Publish timestamp.","type":"string"},"hashtags":{"description":"Hashtags on the post, when available.","type":"array"},"id":{"description":"Post id.","type":"string"},"num_comments":{"description":"Comment count.","type":"number"},"num_likes":{"description":"Like count.","type":"number"},"post_text":{"description":"Post body.","type":"string"},"post_type":{"description":"Post type.","type":"string"},"url":{"description":"Post URL.","type":"string"},"user_id":{"description":"Author handle/id.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"LinkedIn Company Posts","tags":["LinkedIn"]}},"/api/v1/linkedin/job":{"get":{"description":"Fetch a public LinkedIn job posting by URL: title, company, location, and summary. Costs 2 credits per request.","operationId":"linkedin_job_info","parameters":[{"description":"LinkedIn job URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"company_name":"Walmart","job_base_pay_range":"$16.00/hr - $29.00/hr","job_employment_type":"Part-time","job_location":"Fayetteville, NC","job_num_applicants":25,"job_posting_id":"4385163817","job_seniority_level":"Entry level","job_title":"Pharmacy Technician","url":"https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en"},"ok":true},"schema":{"properties":{"data":{"properties":{"company_name":{"description":"Company name.","type":"string"},"job_employment_type":{"description":"Employment type.","type":"string"},"job_location":{"description":"Location.","type":"string"},"job_num_applicants":{"description":"Applicant count, when available.","type":"number"},"job_seniority_level":{"description":"Seniority.","type":"string"},"job_summary":{"description":"Description summary.","type":"string"},"job_title":{"description":"Job title.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"LinkedIn Job","tags":["LinkedIn"]}},"/api/v1/linkedin/post":{"get":{"description":"Fetch a public LinkedIn post by URL: text, likes, comments, and author metadata. Costs 2 credits per request.","operationId":"linkedin_post_info","parameters":[{"description":"LinkedIn post or Pulse URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.linkedin.com/feed/update/urn:li:activity:7516137498180415488/","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"account_type":"Person","date_posted":"2026-03-17T10:30:06.724Z","id":"7439619065922625537","num_comments":3,"num_likes":42,"post_text":"Example LinkedIn post about product updates.","post_type":"post","url":"https://www.linkedin.com/feed/update/urn:li:activity:7516137498180415488/","user_id":"example_author"},"ok":true},"schema":{"properties":{"data":{"properties":{"date_posted":{"description":"Publish timestamp.","type":"string"},"id":{"description":"Post id.","type":"string"},"num_comments":{"description":"Comment count.","type":"number"},"num_likes":{"description":"Like count.","type":"number"},"post_text":{"description":"Post body.","type":"string"},"post_type":{"description":"Post type.","type":"string"},"user_id":{"description":"Author handle/id.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"LinkedIn Post","tags":["LinkedIn"]}},"/api/v1/linkedin/profile":{"get":{"description":"Fetch a public LinkedIn person profile by URL: name, about, current company, and followers. Costs 3 credits per request.","operationId":"linkedin_profile_info","parameters":[{"description":"LinkedIn profile URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.linkedin.com/in/satyanadella","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"about":"Chairman and CEO at Microsoft.","city":"Redmond","connections":500,"country_code":"US","current_company":{"company_id":"microsoft","link":"https://www.linkedin.com/company/microsoft","name":"Microsoft"},"followers":10842560,"name":"Satya Nadella","url":"https://www.linkedin.com/in/satyanadella"},"ok":true},"schema":{"properties":{"data":{"properties":{"about":{"description":"About / summary text.","type":"string"},"city":{"description":"City, when available.","type":"string"},"connections":{"description":"Connection count, when available.","type":"number"},"country_code":{"description":"Country code.","type":"string"},"current_company":{"description":"Current company object (name, link, id).","type":"object"},"followers":{"description":"Follower count.","type":"number"},"name":{"description":"Display name.","type":"string"},"url":{"description":"Canonical profile URL, when available.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"LinkedIn Profile","tags":["LinkedIn"]}},"/api/v1/reddit/comments":{"get":{"description":"Fetch public comments for a post via its permalink. Costs 3 credits per request.","operationId":"reddit_post_comments","parameters":[{"description":"Post permalink from Search or Subreddit Posts.","in":"query","name":"permalink","required":true,"schema":{"example":"/r/SkincareAddiction/comments/8pv3gg/ba_finished_my_5_month_course_of_accutane_just_in/","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"data":{"author":"example_user","body":"Congrats!","score":420},"kind":"t1"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"comments[].data.author":{"description":"Comment author.","type":"string"},"comments[].data.body":{"description":"Comment text.","type":"string"},"comments[].data.score":{"description":"Score.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Reddit Post Comments","tags":["Reddit"]}},"/api/v1/reddit/posts":{"get":{"description":"Fetch posts from a public subreddit. Priced per page. Costs 2 credits per request. Credits scale with the depth query parameter (per page).","operationId":"reddit_subreddit_posts","parameters":[{"description":"Subreddit name without r/.","in":"query","name":"name","required":true,"schema":{"example":"SkincareAddiction","type":"string"}},{"description":"hot | new | top | rising. Defaults to new.","in":"query","name":"sort","required":false,"schema":{"example":"new","type":"string"}},{"description":"Time filter for sort=top. Defaults to week.","in":"query","name":"period","required":false,"schema":{"example":"week","type":"string"}},{"description":"Pagination cursor from a previous nextCursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"data":{"author":"example_user","num_comments":812,"permalink":"/r/SkincareAddiction/comments/8pv3gg/example/","score":22353,"subreddit":"SkincareAddiction","title":"Example post title"},"kind":"t3"}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].data.author":{"description":"Author username.","type":"string"},"[].data.num_comments":{"description":"Comment count.","type":"number"},"[].data.permalink":{"description":"Permalink (use with Comments).","type":"string"},"[].data.score":{"description":"Score.","type":"number"},"[].data.title":{"description":"Post title.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Reddit Subreddit Posts","tags":["Reddit"]}},"/api/v1/reddit/search":{"get":{"description":"Search public Reddit posts by keyword. Priced per page. Costs 2 credits per request. Credits scale with the depth query parameter (per page).","operationId":"reddit_keyword_search","parameters":[{"description":"Keyword to search.","in":"query","name":"name","required":true,"schema":{"example":"bitcoin","type":"string"}},{"description":"relevance | hot | new | top | comments. Defaults to relevance.","in":"query","name":"sort","required":false,"schema":{"example":"relevance","type":"string"}},{"description":"hour | day | week | month | year | all. Defaults to week.","in":"query","name":"period","required":false,"schema":{"example":"week","type":"string"}},{"description":"Pagination cursor from a previous nextCursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"nextCursor":"t3_abc123","posts":[{"data":{"author":"example_user","permalink":"/r/wallstreetbets/comments/abc123/example/","score":1200,"subreddit":"wallstreetbets","title":"Example bitcoin discussion"},"kind":"t3"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"nextCursor":{"description":"Pass as cursor for the next page.","type":"string"},"posts[].data.author":{"description":"Author username.","type":"string"},"posts[].data.permalink":{"description":"Permalink (use with Comments).","type":"string"},"posts[].data.score":{"description":"Score.","type":"number"},"posts[].data.subreddit":{"description":"Subreddit name.","type":"string"},"posts[].data.title":{"description":"Post title.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Reddit Keyword Search","tags":["Reddit"]}},"/api/v1/snapchat/profile":{"get":{"description":"Fetch a public Snapchat profile by username: bio, subscribers, and avatar. Costs 3 credits per request.","operationId":"snapchat_profile","parameters":[{"description":"Snapchat username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"avatar":"https://cf-st.sc-cdn.net/example.jpg","bio":"welcome to my snap yo!!!","name":"David Dobrik","subscribers":6881500,"url":"https://www.snapchat.com/add/daviddobrik","username":"daviddobrik"},"ok":true},"schema":{"properties":{"data":{"properties":{"avatar":{"description":"Profile picture URL.","type":"string"},"bio":{"description":"Bio text.","type":"string"},"name":{"description":"Display name.","type":"string"},"subscribers":{"description":"Subscriber count.","type":"number"},"url":{"description":"Public profile URL.","type":"string"},"username":{"description":"Username.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Profile","tags":["Snapchat"]}},"/api/v1/threads/post":{"get":{"description":"Fetch a post and its popular replies by post id (or shortcode). Costs 3 credits per request.","operationId":"threads_post_replies","parameters":[{"description":"Post id from User Posts. Use any integer if passing shortcode only.","in":"query","name":"id","required":true,"schema":{"example":"3407843880258348330","type":"string"}},{"description":"Optional post shortcode (e.g. from threads.com).","in":"query","name":"shortcode","required":false,"schema":{"example":"C_1g_CcypKE","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"node":{"thread_items":[{"post":{"caption":{"text":"Game day."},"like_count":158,"pk":"3407843880258348330","user":{"username":"orlandomagic"}}}]}}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].node.thread_items[].post.caption.text":{"description":"Text.","type":"string"},"[].node.thread_items[].post.like_count":{"description":"Like count.","type":"number"},"[].node.thread_items[].post.pk":{"description":"Post or reply id.","type":"string"},"[].node.thread_items[].post.user.username":{"description":"Author username.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Threads Post \u0026 Replies","tags":["Threads"]}},"/api/v1/threads/posts":{"get":{"description":"Fetch recent public posts for a user id. Priced per post returned; defaults to 3 posts. Costs 1 credit per request. Credits scale with chunk_size (per item).","operationId":"threads_user_posts","parameters":[{"description":"Numeric user id from User Info.","in":"query","name":"id","required":true,"schema":{"example":"63286282350","type":"string"}},{"description":"How many posts to fetch (max ~20–30). Defaults to 3.","in":"query","name":"chunk_size","required":false,"schema":{"example":"3","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"node":{"thread_items":[{"post":{"caption":{"text":"Game day."},"code":"C_1g_CcypKE","like_count":158,"pk":"3407843880258348330","user":{"pk":"63286282350","username":"orlandomagic"}}}]}}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].node.thread_items[].post.caption.text":{"description":"Caption text.","type":"string"},"[].node.thread_items[].post.code":{"description":"Post shortcode.","type":"string"},"[].node.thread_items[].post.like_count":{"description":"Like count.","type":"number"},"[].node.thread_items[].post.pk":{"description":"Post id.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Threads User Posts","tags":["Threads"]}},"/api/v1/threads/profile":{"get":{"description":"Fetch a public Threads profile by username or numeric id: bio, followers, and verification. Passing username resolves the id internally (8 credits); id alone is 4 credits. Costs 4 credits per request.","operationId":"threads_profile","parameters":[{"description":"Threads username without @. Resolved to id internally.","in":"query","name":"username","required":false,"schema":{"example":"orlandomagic","type":"string"}},{"description":"Numeric user id. Use when already known.","in":"query","name":"id","required":false,"schema":{"example":"63286282350","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"biography":"building the culture in the O","follower_count":276177,"full_name":"Orlando Magic","is_verified":true,"pk":"63286282350","profile_pic_url":"https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg","username":"orlandomagic"},"ok":true},"schema":{"properties":{"data":{"properties":{"biography":{"description":"Bio text.","type":"string"},"follower_count":{"description":"Follower count.","type":"number"},"full_name":{"description":"Display name.","type":"string"},"is_verified":{"description":"Whether verified.","type":"boolean"},"pk":{"description":"User id.","type":"string"},"profile_pic_url":{"description":"Profile picture URL.","type":"string"},"username":{"description":"Username.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Profile","tags":["Threads"]}},"/api/v1/threads/search":{"get":{"description":"Search public posts by query (Threads returns a small batch per call). Costs 3 credits per request.","operationId":"threads_search","parameters":[{"description":"Search text.","in":"query","name":"query","required":true,"schema":{"example":"ferrari","type":"string"}},{"description":"0 = top, 1 = recent. Defaults to 0.","in":"query","name":"sorting","required":false,"schema":{"example":"0","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"node":{"thread":{"thread_items":[{"post":{"caption":{"text":"Example post about ferrari."},"like_count":158,"pk":"3455813358522634884","user":{"username":"amahnke"}}}]}}}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].node.thread.thread_items[].post.like_count":{"description":"Like count.","type":"number"},"[].node.thread.thread_items[].post.pk":{"description":"Post id.","type":"string"},"[].node.thread.thread_items[].post.user.username":{"description":"Author.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Search","tags":["Threads"]}},"/api/v1/tiktok/comments":{"get":{"description":"Fetch comments for a video. Provide id or url. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_comments","parameters":[{"description":"Video id or url (provide one).","in":"query","name":"id","required":false,"schema":{"example":"7165262254722534698","type":"string"}},{"description":"Full TikTok video URL (alternative to id).","in":"query","name":"url","required":false,"schema":{"example":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"author":{"id":"6919985905534190598","username":"viewer123"},"created_at":1667844000,"id":"7123456789012345678","likes":1200,"text":"this is hilarious"}],"cursor":"30"},"ok":true},"schema":{"properties":{"data":{"properties":{"comments":{"description":"Comments for this page.","type":"array"},"comments[].author":{"description":"Author username and id.","type":"object"},"comments[].created_at":{"description":"Unix timestamp, when available.","type":"number"},"comments[].id":{"description":"Comment id.","type":"string"},"comments[].likes":{"description":"Like count.","type":"number"},"comments[].text":{"description":"Comment text.","type":"string"},"cursor":{"description":"Pass as cursor for the next page.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Comments","tags":["TikTok"]}},"/api/v1/tiktok/download":{"get":{"description":"Resolve a downloadable video URL for a TikTok post. Costs 1 credit per request.","operationId":"tiktok_download","parameters":[{"description":"Full TikTok video URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"id":"7165262254722534698","url":"https://v16-webapp-prime.tiktok.com/video/tos/example.mp4"},"ok":true},"schema":{"properties":{"data":{"properties":{"id":{"description":"Video id, when available.","type":"string"},"url":{"description":"Downloadable media URL.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Download","tags":["TikTok"]}},"/api/v1/tiktok/followers":{"get":{"description":"Fetch a page of followers for a username. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_followers","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"1668768146","users":[{"avatar":"https://p16-sign-va.tiktokcdn.com/example.webp","id":"6919985905534190598","name":"Example Fan","username":"example_fan","verified":false}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Follower profiles for this page.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Followers","tags":["TikTok"]}},"/api/v1/tiktok/following":{"get":{"description":"Fetch a page of accounts a username follows. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_following","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"1668768146","users":[{"avatar":"https://p16-sign-va.tiktokcdn.com/example.webp","id":"123456789","name":"Friend","username":"friend_account","verified":false}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Following profiles for this page.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Following","tags":["TikTok"]}},"/api/v1/tiktok/hashtag":{"get":{"description":"Fetch public metadata for a TikTok hashtag. Costs 1 credit per request.","operationId":"tiktok_hashtag","parameters":[{"description":"Hashtag name without #.","in":"query","name":"name","required":true,"schema":{"example":"comedy","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"id":"42164","name":"comedy","videos":8900000,"views":45200000000},"ok":true},"schema":{"properties":{"data":{"properties":{"id":{"description":"Hashtag id.","type":"string"},"name":{"description":"Hashtag name.","type":"string"},"videos":{"description":"Video count, when available.","type":"number"},"views":{"description":"View count, when available.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Hashtag","tags":["TikTok"]}},"/api/v1/tiktok/hashtag-videos":{"get":{"description":"Fetch videos for a hashtag. Provide id (from Hashtag) or name. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_hashtag_videos","parameters":[{"description":"Hashtag id from Hashtag, or name (provide one).","in":"query","name":"id","required":false,"schema":{"example":"42164","type":"string"}},{"description":"Hashtag name without # (alternative to id).","in":"query","name":"name","required":false,"schema":{"example":"comedy","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"20","videos":[{"author":{"id":"7119601","username":"daviddobrik"},"caption":"classic bit","comments":2100,"cover":"https://p16-sign-va.tiktokcdn.com/example.jpeg","created_at":1667843879,"duration":28,"id":"7165262254722534698","likes":410000,"plays":5400000,"shares":18000,"url":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"videos":{"description":"Videos for this page.","type":"array"},"videos[].caption":{"description":"Caption.","type":"string"},"videos[].id":{"description":"Video id.","type":"string"},"videos[].likes":{"description":"Like count.","type":"number"},"videos[].plays":{"description":"Play count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Hashtag Videos","tags":["TikTok"]}},"/api/v1/tiktok/liked":{"get":{"description":"Fetch publicly liked videos for a username. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_liked","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"1699553318000","videos":[{"author":{"id":"999","username":"someone"},"caption":"funny clip","comments":900,"cover":"https://p16-sign-va.tiktokcdn.com/example.jpeg","created_at":1660000000,"duration":15,"id":"7000000000000000001","likes":150000,"plays":2000000,"shares":4000,"url":"https://www.tiktok.com/@someone/video/7000000000000000001"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"videos":{"description":"Liked videos for this page.","type":"array"},"videos[].caption":{"description":"Caption.","type":"string"},"videos[].id":{"description":"Video id.","type":"string"},"videos[].likes":{"description":"Like count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Liked","tags":["TikTok"]}},"/api/v1/tiktok/music":{"get":{"description":"Resolve music/audio metadata and download URL for a TikTok video. Costs 1 credit per request.","operationId":"tiktok_music","parameters":[{"description":"Full TikTok video URL.","in":"query","name":"url","required":true,"schema":{"example":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"author":"daviddobrik","duration":42,"id":"6789012345678901234","title":"original sound - daviddobrik","url":"https://sf16-ies-music-va.tiktokcdn.com/example.mp3"},"ok":true},"schema":{"properties":{"data":{"properties":{"author":{"description":"Track author/artist.","type":"string"},"duration":{"description":"Duration in seconds, when available.","type":"number"},"id":{"description":"Music id, when available.","type":"string"},"title":{"description":"Track title.","type":"string"},"url":{"description":"Audio download URL, when available.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Music","tags":["TikTok"]}},"/api/v1/tiktok/playlists":{"get":{"description":"Fetch public playlists for a username. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_playlists","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"","playlists":[{"cover":"https://p16-sign-va.tiktokcdn.com/example.jpeg","id":"7500000000000000001","name":"Favorites","videos":24}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"playlists":{"description":"Playlists for this page.","type":"array"},"playlists[].id":{"description":"Playlist id.","type":"string"},"playlists[].name":{"description":"Playlist name.","type":"string"},"playlists[].videos":{"description":"Video count, when available.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Playlists","tags":["TikTok"]}},"/api/v1/tiktok/profile":{"get":{"description":"Fetch a public TikTok profile by username: bio, stats, verification, and avatar. Costs 1 credit per request.","operationId":"tiktok_profile","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"avatar":"https://p16-sign-va.tiktokcdn.com/example.webp","bio":"Tap down below :)","followers":26357770,"following":214,"id":"7119601","likes":1304183341,"name":"DAVID DOBRIK","private":false,"sec_uid":"MS4wLjABAAAALJEOFGMMb1NGn73hAlyCaNThVNS4NE9WfE-T4JA_mtg","url":"https://www.tiktok.com/@daviddobrik","username":"daviddobrik","verified":true,"videos":629},"ok":true},"schema":{"properties":{"data":{"properties":{"avatar":{"description":"Avatar URL.","type":"string"},"bio":{"description":"Profile bio.","type":"string"},"followers":{"description":"Follower count.","type":"number"},"following":{"description":"Following count.","type":"number"},"id":{"description":"User id.","type":"string"},"likes":{"description":"Total likes received.","type":"number"},"name":{"description":"Display name.","type":"string"},"private":{"description":"Whether private.","type":"boolean"},"sec_uid":{"description":"Secondary id used by some internal resolves.","type":"string"},"url":{"description":"Profile URL.","type":"string"},"username":{"description":"Username.","type":"string"},"verified":{"description":"Whether verified.","type":"boolean"},"videos":{"description":"Public video count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Profile","tags":["TikTok"]}},"/api/v1/tiktok/replies":{"get":{"description":"Fetch replies to a comment by comment id. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_replies","parameters":[{"description":"Comment id.","in":"query","name":"id","required":true,"schema":{"example":"7123456789012345678","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"author":{"id":"555","username":"reply_user"},"created_at":1667844100,"id":"7123456789012345699","likes":12,"text":"agreed"}],"cursor":""},"ok":true},"schema":{"properties":{"data":{"properties":{"comments":{"description":"Replies for this page.","type":"array"},"comments[].author":{"description":"Author username and id.","type":"object"},"comments[].id":{"description":"Reply id.","type":"string"},"comments[].likes":{"description":"Like count.","type":"number"},"comments[].text":{"description":"Reply text.","type":"string"},"cursor":{"description":"Pass as cursor for the next page.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Replies","tags":["TikTok"]}},"/api/v1/tiktok/search":{"get":{"description":"Search public TikTok users or content by query. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_search","parameters":[{"description":"Search text.","in":"query","name":"query","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"10","users":[{"avatar":"https://p16-sign-va.tiktokcdn.com/example.webp","followers":26357770,"id":"7119601","name":"DAVID DOBRIK","username":"daviddobrik","verified":true}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Matching users, when present.","type":"array"},"users[].followers":{"description":"Follower count, when present.","type":"number"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Search","tags":["TikTok"]}},"/api/v1/tiktok/suggested":{"get":{"description":"Fetch suggested related accounts for a username. Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_suggested","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"","users":[{"avatar":"https://p16-sign-va.tiktokcdn.com/example.webp","id":"123456789","name":"Jason Nash","username":"jasonnash","verified":true}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"users":{"description":"Suggested profiles.","type":"array"},"users[].avatar":{"description":"Avatar URL.","type":"string"},"users[].id":{"description":"User id.","type":"string"},"users[].name":{"description":"Display name.","type":"string"},"users[].username":{"description":"Username.","type":"string"},"users[].verified":{"description":"Whether verified.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Suggested","tags":["TikTok"]}},"/api/v1/tiktok/video":{"get":{"description":"Fetch public details for a single TikTok video. Provide url or id. Costs 1 credit per request.","operationId":"tiktok_video","parameters":[{"description":"Full TikTok video URL or id (provide one).","in":"query","name":"url","required":false,"schema":{"example":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698","type":"string"}},{"description":"Video id (alternative to url).","in":"query","name":"id","required":false,"schema":{"example":"7165262254722534698","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"author":{"id":"7119601","username":"daviddobrik"},"caption":"behind the scenes","comments":4200,"cover":"https://p16-sign-va.tiktokcdn.com/example.jpeg","created_at":1667843879,"duration":42,"id":"7165262254722534698","likes":890000,"plays":12450000,"shares":31000,"url":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698"},"ok":true},"schema":{"properties":{"data":{"properties":{"author":{"description":"Author username and id.","type":"object"},"caption":{"description":"Caption.","type":"string"},"comments":{"description":"Comment count.","type":"number"},"cover":{"description":"Cover image URL.","type":"string"},"created_at":{"description":"Unix publish timestamp.","type":"number"},"duration":{"description":"Duration in seconds.","type":"number"},"id":{"description":"Video id.","type":"string"},"likes":{"description":"Like count.","type":"number"},"plays":{"description":"Play count.","type":"number"},"shares":{"description":"Share count.","type":"number"},"url":{"description":"Video URL.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Video","tags":["TikTok"]}},"/api/v1/tiktok/videos":{"get":{"description":"Fetch recent public videos for a username (sec_uid resolved internally). Priced per page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"tiktok_videos","parameters":[{"description":"TikTok username without @.","in":"query","name":"username","required":true,"schema":{"example":"daviddobrik","type":"string"}},{"description":"Pagination cursor from a previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"cursor":"1699553318000","videos":[{"author":{"id":"7119601","username":"daviddobrik"},"caption":"behind the scenes","comments":4200,"cover":"https://p16-sign-va.tiktokcdn.com/example.jpeg","created_at":1667843879,"duration":42,"id":"7165262254722534698","likes":890000,"plays":12450000,"shares":31000,"url":"https://www.tiktok.com/@daviddobrik/video/7165262254722534698"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"cursor":{"description":"Pass as cursor for the next page.","type":"string"},"videos":{"description":"Videos for this page.","type":"array"},"videos[].author":{"description":"Author username and id.","type":"object"},"videos[].caption":{"description":"Caption.","type":"string"},"videos[].comments":{"description":"Comment count.","type":"number"},"videos[].cover":{"description":"Cover image URL.","type":"string"},"videos[].created_at":{"description":"Unix publish timestamp.","type":"number"},"videos[].duration":{"description":"Duration in seconds.","type":"number"},"videos[].id":{"description":"Video id.","type":"string"},"videos[].likes":{"description":"Like count.","type":"number"},"videos[].plays":{"description":"Play count.","type":"number"},"videos[].shares":{"description":"Share count.","type":"number"},"videos[].url":{"description":"Video URL.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Videos","tags":["TikTok"]}},"/api/v1/twitch/followers":{"get":{"description":"Fetch the public follower count for a Twitch channel username. Costs 1 credit per request.","operationId":"twitch_user_followers","parameters":[{"description":"Channel login without @.","in":"query","name":"username","required":true,"schema":{"example":"hmatttv","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":124198,"ok":true},"schema":{"properties":{"data":{"properties":{"(root)":{"description":"Follower count.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Twitch Follower Count","tags":["Twitch"]}},"/api/v1/twitch/search":{"get":{"description":"Search public Twitch videos, channels, or games by keyword (~15 per page). Priced per page; defaults to 1 page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"twitch_keyword_search","parameters":[{"description":"Search text.","in":"query","name":"keyword","required":true,"schema":{"example":"magic","type":"string"}},{"description":"videos | channels | games. Defaults to videos.","in":"query","name":"type","required":false,"schema":{"example":"videos","type":"string"}},{"description":"Pages to fetch. Defaults to 1.","in":"query","name":"depth","required":false,"schema":{"example":"1","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"item":{"id":"2613189376","owner":{"displayName":"Magic","login":"magic"},"title":"Example stream VOD","viewCount":14337}}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].item.id":{"description":"Result id.","type":"string"},"[].item.owner.login":{"description":"Channel login.","type":"string"},"[].item.title":{"description":"Title (videos).","type":"string"},"[].item.viewCount":{"description":"View count, when present.","type":"number"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Twitch Search","tags":["Twitch"]}},"/api/v1/twitter/post":{"get":{"description":"Fetch public details and stats for a tweet by id. Costs 2 credits per request.","operationId":"twitter_post_info","parameters":[{"description":"Tweet id.","in":"query","name":"id","required":true,"schema":{"example":"1694791112567967849","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"author":{"id":"44196397","is_blue_verified":true,"name":"Elon Musk","username":"elonmusk"},"created_at":"Wed Aug 23 17:00:00 +0000 2023","id":"1694791112567967849","likes":12000,"quotes":120,"replies":800,"retweets":3400,"text":"Example tweet"},"ok":true},"schema":{"properties":{"data":{"properties":{"author.username":{"description":"Author username.","type":"string"},"created_at":{"description":"Tweet timestamp.","type":"string"},"id":{"description":"Tweet id.","type":"string"},"likes":{"description":"Like count.","type":"number"},"quotes":{"description":"Quote count.","type":"number"},"replies":{"description":"Reply count.","type":"number"},"retweets":{"description":"Retweet count.","type":"number"},"text":{"description":"Tweet text.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"X Post Info","tags":["X"]}},"/api/v1/twitter/profile":{"get":{"description":"Fetch a public X profile by username: bio, followers, and verification. Costs 2 credits per request.","operationId":"twitter_profile","parameters":[{"description":"Username without @.","in":"query","name":"username","required":true,"schema":{"example":"elonmusk","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"avatar":"https://pbs.twimg.com/profile_images/example.jpg","bio":"Example bio","followers":150000000,"following":500,"id":"44196397","name":"Elon Musk","tweets":30000,"url":"https://x.com/elonmusk","username":"elonmusk","verified":true},"ok":true},"schema":{"properties":{"data":{"properties":{"avatar":{"description":"Avatar URL.","type":"string"},"bio":{"description":"Profile bio.","type":"string"},"followers":{"description":"Follower count.","type":"number"},"following":{"description":"Following count.","type":"number"},"id":{"description":"Numeric user id (for Tweets).","type":"string"},"name":{"description":"Display name.","type":"string"},"tweets":{"description":"Tweet count.","type":"number"},"url":{"description":"Profile URL.","type":"string"},"username":{"description":"Username without @.","type":"string"},"verified":{"description":"Whether the account has a blue check.","type":"boolean"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Profile","tags":["X"]}},"/api/v1/twitter/tweets":{"get":{"description":"Fetch recent public tweets for a user id (from User Info). Best coverage on verified accounts. Response is a compact tweet list (not raw GraphQL). Costs 4 credits per request.","operationId":"twitter_user_tweets","parameters":[{"description":"Numeric user id from User Info (id).","in":"query","name":"id","required":true,"schema":{"example":"44196397","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"author":{"id":"44196397","is_blue_verified":true,"name":"Elon Musk","username":"elonmusk"},"created_at":"Wed Aug 23 17:00:00 +0000 2023","id":"1694791112567967849","lang":"en","likes":12000,"quotes":120,"replies":800,"retweets":3400,"text":"Example tweet","views":"1500000"}],"ok":true},"schema":{"properties":{"data":{"properties":{"[].author.username":{"description":"Author username.","type":"string"},"[].created_at":{"description":"Tweet timestamp.","type":"string"},"[].id":{"description":"Tweet id.","type":"string"},"[].likes":{"description":"Like count.","type":"number"},"[].media[].url":{"description":"Media URL when present.","type":"string"},"[].quotes":{"description":"Quote count.","type":"number"},"[].replies":{"description":"Reply count.","type":"number"},"[].retweets":{"description":"Retweet count.","type":"number"},"[].text":{"description":"Tweet text.","type":"string"},"[].views":{"description":"View count when available.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"X User Tweets","tags":["X"]}},"/api/v1/youtube/channel":{"get":{"description":"Fetch public channel details by username or browse id: description, links, and metadata. Passing username resolves the browse id internally (3 credits); browse_id alone is 2 credits. Costs 2 credits per request.","operationId":"youtube_channel","parameters":[{"description":"Channel handle without @. Resolved to browse_id internally.","in":"query","name":"username","required":false,"schema":{"example":"MrBeast","type":"string"}},{"description":"Channel id (UC…). Use when already known.","in":"query","name":"browse_id","required":false,"schema":{"example":"UCX6OQ3DkcsbYNE6H8uQQuVA","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"metadata":{"aboutChannelViewModel":{"canonicalChannelUrl":"https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA","description":"Thank you for being here :)","subscriberCountText":"100M subscribers"}}},"ok":true},"schema":{"properties":{"data":{"properties":{"metadata.aboutChannelViewModel.canonicalChannelUrl":{"description":"Canonical channel URL, when present.","type":"string"},"metadata.aboutChannelViewModel.description":{"description":"Channel about text.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Channel","tags":["YouTube"]}},"/api/v1/youtube/comments":{"get":{"description":"Fetch a page of public comments for a video or Short. Priced per page. Costs 2 credits per request. Credits scale with the depth query parameter (per page).","operationId":"youtube_video_comments","parameters":[{"description":"YouTube video or Short id.","in":"query","name":"id","required":true,"schema":{"example":"9lhtFHpNfms","type":"string"}},{"description":"Pagination cursor from a previous nextCursor.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"comments":[{"author":"viewer123","likes":42,"text":"great video"}],"nextCursor":"Eg0SC2NLYmI1dHBlcnhjGAYyJS..."},"ok":true},"schema":{"properties":{"data":{"properties":{"comments":{"description":"Comment entries for this page.","type":"array"},"nextCursor":{"description":"Pass as cursor for the next page.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"YouTube Video Comments","tags":["YouTube"]}},"/api/v1/youtube/search":{"get":{"description":"Search public videos by keyword (~20 per page). Priced per page; defaults to 1 page. Costs 1 credit per request. Credits scale with the depth query parameter (per page).","operationId":"youtube_video_search","parameters":[{"description":"Search text.","in":"query","name":"keyword","required":true,"schema":{"example":"magic","type":"string"}},{"description":"Pages to fetch. Defaults to 1.","in":"query","name":"depth","required":false,"schema":{"example":"1","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"videos":[{"channel":"Example Channel","title":"Magic tricks compilation","videoId":"abc123"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"videos":{"description":"Matching videos for this page.","type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"YouTube Search","tags":["YouTube"]}},"/api/v1/youtube/shorts":{"get":{"description":"Fetch Shorts for a channel (~50 per page). Priced per page; defaults to 1 page. Costs 6 credits per request. Credits scale with the depth query parameter (per page).","operationId":"youtube_channel_shorts","parameters":[{"description":"Channel id (UC…). From User Info or a channel URL.","in":"query","name":"browse_id","required":true,"schema":{"example":"UCX6OQ3DkcsbYNE6H8uQQuVA","type":"string"}},{"description":"Pages to fetch. Defaults to 1.","in":"query","name":"depth","required":false,"schema":{"example":"1","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"shorts":[{"title":"Example short","videoId":"9lhtFHpNfms","viewCount":"500000"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"shorts":{"description":"Short entries for this page.","type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Channel Shorts","tags":["YouTube"]}},"/api/v1/youtube/subscribers":{"get":{"description":"Fetch the public subscriber count string for a channel id. Costs 1 credit per request.","operationId":"youtube_channel_subscribers","parameters":[{"description":"Channel id (UC…). From User Info or a channel URL.","in":"query","name":"browse_id","required":true,"schema":{"example":"UCX6OQ3DkcsbYNE6H8uQQuVA","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":"200M","ok":true},"schema":{"properties":{"data":{"properties":{"(root)":{"description":"Subscriber count text (e.g. 12.8K).","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"YouTube Subscriber Count","tags":["YouTube"]}},"/api/v1/youtube/video":{"get":{"description":"Fetch public stats for a video or Short by id. Costs 1 credit per request.","operationId":"youtube_video_info","parameters":[{"description":"YouTube video or Short id.","in":"query","name":"id","required":true,"schema":{"example":"9lhtFHpNfms","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"likeCount":85000,"title":"Example video","videoId":"9lhtFHpNfms","viewCount":"1200000"},"ok":true},"schema":{"properties":{"data":{"properties":{"likeButton.likeButtonRenderer.likeCount":{"description":"Like count, when available.","type":"number"},"viewCount":{"description":"View count text, when present.","type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"YouTube Video Info","tags":["YouTube"]}},"/api/v1/youtube/videos":{"get":{"description":"Fetch recent uploads for a channel (~25 per page). Priced per page; defaults to 1 page. Costs 3 credits per request. Credits scale with the depth query parameter (per page).","operationId":"youtube_channel_videos","parameters":[{"description":"Channel id (UC…). From User Info or a channel URL.","in":"query","name":"browse_id","required":true,"schema":{"example":"UCX6OQ3DkcsbYNE6H8uQQuVA","type":"string"}},{"description":"Pages to fetch. Defaults to 1.","in":"query","name":"depth","required":false,"schema":{"example":"1","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":{"user":{"subscriberCount":"200000000","title":"MrBeast","urlCanonical":"https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA"},"videos":[{"publishedTime":"2 days ago","title":"Example upload","videoId":"dQw4w9WgXcQ","viewCount":"1200000"}]},"ok":true},"schema":{"properties":{"data":{"properties":{"user.title":{"description":"Channel title.","type":"string"},"videos":{"description":"Video entries for this page (shape varies by upstream).","type":"array"}},"type":"object"},"meta":{"$ref":"#/components/schemas/LookupMeta"},"ok":{"example":true,"type":"boolean"},"params":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Lookup succeeded"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid parameters"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized : missing or invalid API key"},"402":{"content":{"application/json":{"schema":{"properties":{"credits_balance":{"type":"integer"},"credits_required":{"type":"integer"},"error":{"type":"string"}},"type":"object"}}},"description":"Insufficient credits"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown platform/resource or upstream not found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream lookup failed"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Service temporarily unavailable"}},"summary":"Channel Videos","tags":["YouTube"]}}},"security":[{"bearerAuth":[]}],"servers":[{"description":"Production","url":"https://trysocify.com"}],"tags":[{"description":"Service metadata and discovery","name":"Meta"},{"description":"Public Instagram profiles, posts, reels, and engagement data.","name":"Instagram"},{"description":"Public TikTok profiles, videos, and engagement data.","name":"TikTok"},{"description":"Public channels, videos, Shorts, and comments.","name":"YouTube"},{"description":"Public Threads profiles, posts, and replies.","name":"Threads"},{"description":"Public subreddit posts, keyword search, and comments.","name":"Reddit"},{"description":"Public LinkedIn companies, jobs, posts, profiles, and company feeds by URL.","name":"LinkedIn"},{"description":"Public Twitch search and channel follower counts.","name":"Twitch"},{"description":"Public X profiles, tweets, and post stats.","name":"X"},{"description":"Public Snapchat profiles.","name":"Snapchat"}]}