Threads Home API
Collect Threads profile information and first-page works.
API Description
Threads Home API — Collect Threads profile information and first-page works.
Authenticate with your Pangolinfo API Key to receive structured JSON data.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| target | Yes | string | Target URL, supported ID or search keyword for this operation. |
Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.
Includes first-page works. Use the works operation, where available, to continue.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for this request. |
| data | object | Collected data, with fields described below. |
| meta | object | Request identifier and duration in milliseconds. |
| billing | object | Charged units, unit price and billing rule version. |
data Fields
| Field | Type | Description |
|---|---|---|
| type | string | Result type. |
| profile | object | Profile details. |
| works | object[] | Collected works. |
| pagination | object | Continuation cursor and whether more results are available. |
data.profile Fields
| Field | Type | Description |
|---|---|---|
| accountId | string | number | null | Account id |
| userId | string | number | null | User id |
| igUserId | string | number | null | Ig user id |
| username | string | null | Username |
| nickname | string | null | Author display name. |
| fullName | string | null | Full name |
| profileUrl | string | Author profile URL. |
| avatar | string | null | Avatar URL. |
| avatarThumb | string | null | Avatar thumb |
| verified | boolean | Verified |
| isVerified | boolean | Is verified |
| isPrivate | boolean | Is private |
| followersCount | number | null | Followers count |
| bio | string | null | Bio |
| biography | string | null | Biography |
| contactEmail | string | null | Contact email |
| externalLinks | string[] | External links |
| bioLinks | object[] | Bio links |
| profileTags | string[] | Profile tags |
| hasOnboardedToTextPostApp | boolean | Has onboarded to text post app |
| showTextPostAppBadge | boolean | Show text post app badge |
| targetUrl | string | Target url |
data.profile.bioLinks[] Fields
| Field | Type | Description |
|---|---|---|
| url | string | null | Content URL. |
| lynxUrl | string | null | Lynx url |
| linkId | string | number | null | Link id |
| title | string | null | Title |
| isVerified | boolean | Is verified |
data.works[] Fields
| Field | Type | Description |
|---|---|---|
| workId | string | number | null | Work id |
| postId | string | number | null | Post id |
| code | string | Status code; 0 indicates success. |
| workType | string | Work type Values: [“video”, “image”, “post”] |
| url | string | Content URL. |
| caption | string | null | Caption |
| content | string | null | Content text; may be null for records without text. |
| takenAt | number | null | Taken at |
| publishedAt | number | null | Publication time. |
| takenAtISO | string | null | Taken at iso |
| likes | number | null | Like count. |
| likeCount | number | null | Like count |
| replyCount | number | null | Platform-reported reply count. |
| repostCount | number | null | Repost count |
| quoteCount | number | null | Quote count |
| isReply | boolean | Is reply |
| hasVideo | boolean | Has video |
| cover | string | null | Cover |
| image | string | null | Image |
| imageWidth | number | null | Image width |
| imageHeight | number | null | Image height |
| videoUrl | string | null | Video url |
| accessibilityCaption | string | null | Accessibility caption |
| audience | string | null | Audience |
| shareCount | number | null | Share count |
| media | object[] | Media |
| hashtags | string[] | Hashtags |
| mentions | string[] | Mentions |
| links | string[] | Links |
| linkPreview | object | null | Link preview |
data.works[].media[] Fields
| Field | Type | Description |
|---|---|---|
| type | string | Result type. |
| imageUrl | string | null | Image url |
| videoUrl | string | null | Video url |
| width | number | null | Width |
| height | number | null | Height |
| accessibilityCaption | string | null | Accessibility caption |
data.works[].linkPreview Fields
| Field | Type | Description |
|---|---|---|
| url | string | null | Content URL. |
| displayUrl | string | null | Display url |
| title | string | null | Title |
| imageUrl | string | null | Image url |
data.pagination Fields
| Field | Type | Description |
|---|---|---|
| endCursor | string | null | Cursor for continuing the works list. |
| hasMore | boolean | Whether more results are available. |
Request Example
Response Example
This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.
Points Usage
0.8 points per profile. Included works are free.
Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

