# Threads API
> 32 endpoints for live Meta Threads data — users, posts, search, topics, trending, URL helpers.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/threads-api/..."
```

## Pricing
- **Free** (Free) — 100 calls/Mo, 1 req/s
- **Basic** ($15/Mo) — 25,000 calls/Mo, 10 req/s
- **Pro** ($49/Mo) — 100,000 calls/Mo, 20 req/s
- **Mega** ($149/Mo) — 500,000 calls/Mo, 50 req/s

## Endpoints

### Users

#### `GET /api/v1/users/search` — Search users

Threads-Nutzer-Suche per Volltext.

**Parameters:**
- `query` (query, required, string) — Search text Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/search?query=zuck"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "site:threads.com/@ zuck Threads profile",
        "results": [
            {
                "url": "https://www.threads.com/@zuck",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "zuck",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/post/DHbau1vvgLl?hl=en",
                "title": "Show people what you're into by adding topics to your profile.",
                "source": "live_web_search",
                "snippet": "› @zuck",
                "username": "zuck",
                "post_code": "DHbau1vvgLl"
            },
            {
                "url": "https://www.threads.com/@zuck/post/C4s6IiDL9rW?hl=en-gb",
                "title": "Show people what you're into by adding topics to your profile.",
                "source": "live_web_search",
                "snippet": "Show people what you're into by adding topics to your profile. 5.5M Followers • 144 Threads • Mostly superintelligence and MMA takes. See the latest conversations with @ zuck .",
                "username": "zuck",
                "post_code": "C4s6IiDL9rW"
            },
            {
                "url": "https://www.threads.com/@shaiba_hussain/post/DN8J5j5iDJZ/my-stupid-timeline-is-stuck-again-what-the-hell-threads-zuck",
                "title
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/users/profile` — User profile

Vollständiges Profil per Username.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/profile?username=zuck"
```

**Response:**
```json
{
    "data": {
        "matched": {
            "url": "https://www.threads.com/@zuck",
            "title": null,
            "source": "live_web_search",
            "snippet": "Clear filter",
            "username": "zuck",
            "post_code": null
        },
        "username": "zuck",
        "profile_url": "https://www.threads.net/@zuck",
        "source_results": [
            {
                "url": "https://www.threads.com/@zuck",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "zuck",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/post/Cywjyrdv9T6",
                "title": "Good conversation with @hubermanlab and @cillachan about science…",
                "source": "live_web_search",
                "snippet": "› @zuck",
                "username": "zuck",
                "post_code": "Cywjyrdv9T6"
            },
            {
                "url": "https://www.threads.com/@zuck/post/DEhgYx4JbEG?hl=en",
                "title": "Good conversation with @hubermanlab and @cillachan about science…",
                "source": "live_web_search",
                "snippet": "Good conversation with @hubermanlab and @cillachan about science… Good conversation with @hubermanlab and @cillachan about science, AI, and mixed reality. Check out the full episode on YouTube. https://www.youtube. com 
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/users/links` — User links

Bio-Links eines Users.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/links?username=zuck"
```

**Response:**
```json
{
    "data": {
        "links": [
            "https://www.threads.com/@zuck/post/C4s6IiDL9rW/trending-now-is-rolling-out-to-the-us-today-so-you-can-see-what-people-are-talki",
            "https://www.threads.com/@zuck/post/DBHNEHYyCwv",
            "https://www.threads.com/@zuck/post/C4dPc4XrCcx",
            "https://www.threads.com/@zuck/post/DKudiKcRO4i",
            "https://www.threads.com/@zuck/post/DNQtqzGRWA7/threads-on-the-up-and-up-just-passed-400m-monthly-actives-on-here?hl=en",
            "https://www.threads.com/@zuck/post/DEhga1cJGjg?hl=en",
            "https://www.threads.com/@zuck/post/C89oeSORn81",
            "https://www.threads.com/@zuck/post/C40wRjXRGte",
            "https://www.threads.com/@zuck/post/DR0F9gkEj1q",
            "https://www.threads.com/@zuck/post/DK-BydcJHkF?xmt=AQF09bmx0yUaFf_wsC-OwORirobNRARXgqCf__v7ObumgA",
            "https://www.threads.com/@zuck/post/CwP2yyiL15R?hl=en",
            "https://www.threads.com/@zuck/post/C8WQyIVOd8t",
            "https://www.threads.com/@zuck/media",
            "https://www.threads.com/@zuck/post/DORJoYgkXUH",
            "https://www.threads.com/@zuck/post/DO_ToA1Ed2L/fun-milestone-update-for-anyone-keeping-count-instagram-now-has-3-billion-monthl"
        ],
        "results": [
            {
                "url": "https://www.threads.com/@zuck/post/C4s6IiDL9rW/trending-now-is-rolling-out-to-the-us-today-so-you-can-see-what-people-are-talki",
                "title": null,
                "so
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/users/top-result` — Top user

Bester Treffer für Username-Query.

**Parameters:**
- `query` (query, required, string) — Search text Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/top-result?query=zuck"
```

**Response:**
```json
{
    "data": {
        "query": "zuck",
        "result": {
            "url": "https://www.threads.com/@zuck",
            "title": "search operators",
            "source": "live_web_search",
            "snippet": "Too few matches were found",
            "username": "zuck",
            "post_code": null
        },
        "live_search_available": true
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:17.681Z",
        "request_id": "1fffd7f2-d9ea-479d-85a5-8d0b043e0a1f"
    },
    "status": "ok",
    "message": "User top result retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/users/posts` — User posts

Posts eines Users.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/posts?username=zuck"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.com/@zuck/post zuck",
        "results": [
            {
                "url": "https://www.threads.com/@zuck/post/DW4Gb79kQc0/today-were-sharing-our-new-model-family-muse-and-releasing-our-first-model",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "zuck",
                "post_code": "DW4Gb79kQc0"
            },
            {
                "url": "https://www.threads.com/@zuck/post/DR0WsxRklXy?xmt=AQF0z3hzh412YUSDB4cy2eyXHzKgov3sFisrS-pc1qSvvQ",
                "title": "Mark Zuckerberg (@zuck) on Threads",
                "source": "live_web_search",
                "snippet": "Today we're sharing our new model family, Muse, and ...",
                "username": "zuck",
                "post_code": "DR0WsxRklXy"
            },
            {
                "url": "https://www.threads.com/@zuck/post/DNQtqzGRWA7/threads-on-the-up-and-up-just-passed-400m-monthly-actives-on-here",
                "title": "Mark Zuckerberg (@zuck) on Threads",
                "source": "live_web_search",
                "snippet": "We're entering a new era where AI glasses and other devices will change how we connect with technology and each other. The potential is enormous, but what matters most is making these experiences feel natural and truly centered around people. With this new studio, we're focused on making 
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/users/replies` — User replies

Replies eines Users.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/users/replies?username=zuck"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "site:threads.com/@zuck replies zuck",
        "results": [
            {
                "url": "https://www.threads.com/@zuck",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "zuck",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/replies",
                "title": null,
                "source": "live_web_search",
                "snippet": "Mark Zuckerberg (@zuck) • Threads, Say more",
                "username": "zuck",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/post/DO_ToA1Ed2L/fun-milestone-update-for-anyone-keeping-count-instagram-now-has-3-billion-monthl",
                "title": null,
                "source": "live_web_search",
                "snippet": "Threads 5.5M Followers • 144 Threads • Mostly superintelligence and MMA takes. See the latest conversations with @zuck.",
                "username": "zuck",
                "post_code": "DO_ToA1Ed2L"
            },
            {
                "url": "https://www.threads.com/@zuck/post/DMF6tMAxkX8/for-our-superintelligence-effort-im-focused-on-building-the-most-elite-and-talen",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": 
…(truncated, see openapi.json for full schema)
```

### Posts

#### `GET /api/v1/posts/search` — Search posts

Post-Suche per Volltext.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/search?query=meta"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.net/@*/post meta",
        "results": [
            {
                "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
                "title": null,
                "source": "live_web_search",
                "snippet": "Meta 3 Preisvergleich | top-aktueller Preis 498,94€",
                "username": "portaltic",
                "post_code": "DFcp-ONMZeu"
            },
            {
                "url": "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
                "title": "META ABSOLUTO",
                "source": "live_web_search",
                "snippet": "January 30, 2025 -",
                "username": "tenuxpr",
                "post_code": "DFl5NoFRvky"
            },
            {
                "url": "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
                "title": "META ABSOLUTO",
                "source": "live_web_search",
                "snippet": "META ABSOLUTO META ABSOLUTO - 4 TIROS = DOWN (downsight usa municiones de sniper) #tenux # meta #warzone",
                "username": "manolinyt",
                "post_code": "DFa9KPBoBZl"
            },
            {
                "url": "https://www.threads.com/@theinformation/post/DFa2BmnudfY",
                "title": "META ABSOLUTO",
                "source": "live_web_search",
                "snippet": "META AB
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/posts/search-recent` — Recent posts

Aktuelle Posts (chronologisch sortiert).

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/search-recent?query=meta"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.net/@*/post meta after:2025",
        "results": [
            {
                "url": "https://www.threads.com/@mya4yousocial/post/DFiYGoqs3ul/-facebook-2025-meno-ads-pi%C3%B9-contenutilalgoritmo-cambia-meno-spinta-alle-sponsori",
                "title": null,
                "source": "live_web_search",
                "snippet": "More",
                "username": "mya4yousocial",
                "post_code": "DFiYGoqs3ul"
            },
            {
                "url": "https://www.threads.com/@mattnavarra/post/C2Swp9iIbBN/meta-is-sitting-on-a-stockpile-of-techs-hottest-commoditymeta-will-reportedly-ow",
                "title": null,
                "source": "live_web_search",
                "snippet": "February 1, 2025 -",
                "username": "mattnavarra",
                "post_code": "C2Swp9iIbBN"
            },
            {
                "url": "https://www.threads.net/@mattnavarra/post/DILwh7_qjau/inside-the-facebook-algorithm-in-2025-all-the-updates-you-need-to-knowheres-ever",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "mattnavarra",
                "post_code": "DILwh7_qjau"
            },
            {
                "url": "https://www.threads.com/@realitylabs/post/DDPwsIfyAse/video-meta-quest-december-2024-new-titles-additions-to-the-games-catalog-more-httpswww",
                "t
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/posts/links` — Post links

Links aus Post-Suchergebnissen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/links?query=meta"
```

**Response:**
```json
{
    "data": {
        "links": [
            "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
            "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
            "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
            "https://www.threads.net/@metanewsroom/post/DGiwVXYpNEg",
            "https://www.threads.com/@aguti00/post/C_nd2TXuu6d/-meta-platforms-meta-sorprende-con-un-nuevo-dividendo-meta-acaba-de-anunciar-que",
            "https://www.threads.net/@wzloadoutcodmunity/post/DFiTqVNt_ta",
            "https://www.threads.com/@theinformation/post/DFa2BmnudfY",
            "https://www.threads.com/@owcavalryes/post/DFGgPIzokyu/prep%C3%A1rate-para-overwatch-classic-moth-meta-este-modo-nos-transporta-al-2017-con-",
            "https://www.threads.com/@bermudahillsco/post/DFGue2yMfTo/metas-roadmap-for-future-devices-is-shaping-up-to-be-truly-exciting-for-both-use",
            "https://www.threads.com/@pablinecorreia/post/DFevFYRuK3s",
            "https://www.threads.com/@mikacat1234/post/DGFLE9Dyoca/%E5%BB%A3%E5%91%8A%E6%8A%95%E6%94%BEasc%E5%BB%A3%E5%91%8A%E5%8D%B3%E5%B0%87%E8%B5%B0%E5%85%A5%E6%AD%B7%E5%8F%B2meta-%E5%BB%A3%E5%91%8A%E5%BE%8C%E5%8F%B0%E4%BA%8C%E6%9C%88%E5%8D%B3%E5%B0%87%E6%94%B9%E8%AE%8A%E6%9C%AA%E4%BE%86%E8%A1%8C%E9%8A%B7%E6%B4%BB%E5%8B%95-asc%E8%88%87%E4%B8%80%E8%88%AC%E8%87%AA%E8%A8%82%E5%8F%97%E7%9C%BE%E6%B4%BB%E5%8B%95%E5%B0%87%E5%90%88%E4%BD
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/posts/codes` — Post codes

Post-Shortcodes aus Suchergebnissen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/codes?query=meta"
```

**Response:**
```json
{
    "data": {
        "codes": [
            "DFcp-ONMZeu",
            "DFl5NoFRvky",
            "DFa9KPBoBZl",
            "DGiwVXYpNEg",
            "DFiTqVNt_ta",
            "DFevFYRuK3s",
            "DFa2BmnudfY",
            "C_nd2TXuu6d",
            "DFGue2yMfTo",
            "DFdEWt8RW_I",
            "DGDbWhIRkK1",
            "DFLzJqVusbB",
            "DGFBYtUSCDs",
            "DFkom8FO3Jz",
            "DGFLE9Dyoca"
        ],
        "query": "meta",
        "results": [
            {
                "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
                "title": null,
                "source": "live_web_search",
                "snippet": "Improve your Trading Skills with our Free Content. Your capital is at risk. Explore the eToro Academy & Learn to Trade Smarter with Guides, Videos, Blog Posts & More.",
                "username": "portaltic",
                "post_code": "DFcp-ONMZeu"
            },
            {
                "url": "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
                "title": null,
                "source": "live_web_search",
                "snippet": "January 30, 2025 -",
                "username": "tenuxpr",
                "post_code": "DFl5NoFRvky"
            },
            {
                "url": "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
                "title": null,
                "so
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/posts/top-result` — Top post

Bester Post-Treffer für Query.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/top-result?query=meta"
```

**Response:**
```json
{
    "data": {
        "query": "meta",
        "result": {
            "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
            "title": "search operators",
            "source": "live_web_search",
            "snippet": "Too few matches were found",
            "username": "portaltic",
            "post_code": "DFcp-ONMZeu"
        }
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:27.285Z",
        "request_id": "46800992-ac4d-436a-ac16-d3a8e9da351a"
    },
    "status": "ok",
    "message": "Post top result retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/posts/by-url` — Post by URL

Detail-Daten zu einem Post per URL.

**Parameters:**
- `url` (query, required, string) — Threads post URL Example: `https://www.threads.com/@zuck/post/DPCXhCwkqEe`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/posts/by-url?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDPCXhCwkqEe"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.com/@zuck/post/DPCXhCwkqEe",
        "code": "DPCXhCwkqEe",
        "matched": {
            "url": "https://www.threads.com/@zuck/post/DPCXhCwkqEe/introducing-vibes-a-feed-of-expressive-ai-generated-videos-from-artists-and-crea?hl=en",
            "title": null,
            "source": "live_web_search",
            "snippet": "More",
            "username": "zuck",
            "post_code": "DPCXhCwkqEe"
        },
        "username": "zuck",
        "source_results": [
            {
                "url": "https://www.threads.com/@zuck/post/DPCXhCwkqEe/introducing-vibes-a-feed-of-expressive-ai-generated-videos-from-artists-and-crea?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": "More",
                "username": "zuck",
                "post_code": "DPCXhCwkqEe"
            },
            {
                "url": "https://www.threads.com/tag/zuck",
                "title": "View all",
                "source": "live_web_search",
                "snippet": "View all",
                "username": null,
                "post_code": null
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:33.726Z",
        "request_id": "27591c12-19e5-4b8a-934d-ebd465050d10"
    },
    "status": "ok",
    "message": "Post retrieved successfully",
    "success": true
}
```

### Search

#### `GET /api/v1/search/all` — Search all

Kombinierte Such über Users + Posts + Topics.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/all?query=meta"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "meta",
        "results": [
            {
                "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "portaltic",
                "post_code": "DFcp-ONMZeu"
            },
            {
                "url": "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
                "title": null,
                "source": "live_web_search",
                "snippet": "January 30, 2025 -",
                "username": "tenuxpr",
                "post_code": "DFl5NoFRvky"
            },
            {
                "url": "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "manolinyt",
                "post_code": "DFa9KPBoBZl"
            },
            {
                "url": "https://www.threads.net/@metanewsroom/post/DGiwVXYpNEg",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "metanewsroom",
                "post_code": "DGiwVXYpNEg"
            },
            {
                "url": "https://www.threads.com/@aguti00/post
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/search/users` — Search users

User-Suche.

**Parameters:**
- `query` (query, required, string) — Search text Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/users?query=zuck"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "site:threads.com/@ zuck Threads profile",
        "results": [
            {
                "url": "https://www.threads.com/@zuck",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "zuck",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/post/DHbau1vvgLl?hl=en",
                "title": "Show people what you're into by adding topics to your profile.",
                "source": "live_web_search",
                "snippet": "› @zuck",
                "username": "zuck",
                "post_code": "DHbau1vvgLl"
            },
            {
                "url": "https://www.threads.com/@zuck/post/C4s6IiDL9rW?hl=en-gb",
                "title": "Show people what you're into by adding topics to your profile.",
                "source": "live_web_search",
                "snippet": "Show people what you're into by adding topics to your profile. 5.5M Followers • 144 Threads • Mostly superintelligence and MMA takes. See the latest conversations with @ zuck .",
                "username": "zuck",
                "post_code": "C4s6IiDL9rW"
            },
            {
                "url": "https://www.threads.com/@shaiba_hussain/post/DN8J5j5iDJZ/my-stupid-timeline-is-stuck-again-what-the-hell-threads-zuck",
                "title
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/search/posts` — Search posts

Post-Suche.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/posts?query=meta"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.net/@*/post meta",
        "results": [
            {
                "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "portaltic",
                "post_code": "DFcp-ONMZeu"
            },
            {
                "url": "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
                "title": null,
                "source": "live_web_search",
                "snippet": "January 30, 2025 -",
                "username": "tenuxpr",
                "post_code": "DFl5NoFRvky"
            },
            {
                "url": "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "manolinyt",
                "post_code": "DFa9KPBoBZl"
            },
            {
                "url": "https://www.threads.net/@metanewsroom/post/DGiwVXYpNEg",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "metanewsroom",
                "post_code": "DGiwVXYpNEg"
            },
            {
                "url": "https://www.
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/search/top-result` — Top result

Bester Treffer (1-best-match) über alle Typen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/top-result?query=meta"
```

**Response:**
```json
{
    "data": {
        "query": "meta",
        "result": {
            "url": "https://www.threads.com/@stockmktnewz/post/DXE0RzUicrE/meta-platforms-meta-is-expected-to-bring-in-more-advertising-revenue-than",
            "title": "search operators",
            "source": "live_web_search",
            "snippet": "Too few matches were found",
            "username": "stockmktnewz",
            "post_code": "DXE0RzUicrE"
        }
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:38.288Z",
        "request_id": "8b4f8c06-1b45-465c-a556-d6357391b4bc"
    },
    "status": "ok",
    "message": "Search top result retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/search/links` — Search links

Links aus Suchergebnissen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/links?query=meta"
```

**Response:**
```json
{
    "data": {
        "links": [
            "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
            "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
            "https://www.threads.com/@theinformation/post/DFa2BmnudfY",
            "https://www.threads.com/@aguti00/post/C_nd2TXuu6d/-meta-platforms-meta-sorprende-con-un-nuevo-dividendo-meta-acaba-de-anunciar-que",
            "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
            "https://www.threads.net/@wzloadoutcodmunity/post/DFiTqVNt_ta",
            "https://www.threads.net/@metanewsroom/post/DGiwVXYpNEg",
            "https://www.threads.com/@mikacat1234/post/DGFLE9Dyoca/%E5%BB%A3%E5%91%8A%E6%8A%95%E6%94%BEasc%E5%BB%A3%E5%91%8A%E5%8D%B3%E5%B0%87%E8%B5%B0%E5%85%A5%E6%AD%B7%E5%8F%B2meta-%E5%BB%A3%E5%91%8A%E5%BE%8C%E5%8F%B0%E4%BA%8C%E6%9C%88%E5%8D%B3%E5%B0%87%E6%94%B9%E8%AE%8A%E6%9C%AA%E4%BE%86%E8%A1%8C%E9%8A%B7%E6%B4%BB%E5%8B%95-asc%E8%88%87%E4%B8%80%E8%88%AC%E8%87%AA%E8%A8%82%E5%8F%97%E7%9C%BE%E6%B4%BB%E5%8B%95%E5%B0%87%E5%90%88%E4%BD%B5%E4%B8%8D%E5%86%8D%E5%8D%80%E5%88%86-asc-%E6%88%96%E4%B8%80%E8%88%AC%E9%81%B8%E9%A0%85%E7%B3%BB%E7%B5%B1%E6%9C%83%E9%A0%90%E8%A8%AD%E4%BD%BF%E7%94%A8%E6%9C%80%E4%BD%B3%E5%AF%A6%E4%BD%9C%E6%96%B9%E5%BC%8F%E4%B8%8D",
            "https://www.threads.com/@pablinecorreia/post/DFevFYRuK3s",
            "https://www.threads.com/@caduborges/post/DFkom8FO3Jz",
            "https://w
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/search/suggestions` — Suggestions

Auto-Complete-Vorschläge.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/suggestions?query=meta"
```

**Response:**
```json
{
    "data": {
        "query": "meta",
        "suggestions": [
            "portaltic",
            "dfcp-onmzeu",
            "search",
            "operators",
            "too",
            "few",
            "matches",
            "were",
            "found",
            "https",
            "www",
            "threads"
        ],
        "source_results": [
            {
                "url": "https://www.threads.com/@portaltic/post/DFcp-ONMZeu/el-director-ejecutivo-de-meta-mark-zuckerberg-ha-se%C3%B1alado-que-espera-que-esta-pl",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "portaltic",
                "post_code": "DFcp-ONMZeu"
            },
            {
                "url": "https://www.threads.com/@tenuxpr/post/DFl5NoFRvky",
                "title": null,
                "source": "live_web_search",
                "snippet": "January 30, 2025 -",
                "username": "tenuxpr",
                "post_code": "DFl5NoFRvky"
            },
            {
                "url": "https://www.threads.com/@manolinyt/post/DFa9KPBoBZl",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "manolinyt",
                "post_code": "DFa9KPBoBZl"
            },
            {
                "url": "https://www.threads.com/@theinformation/post/DFa2BmnudfY",
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/search/media` — Search media

Media (Bilder/Videos) aus Suchergebnissen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/search/media?query=meta"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.net/@*/post meta video OR photo",
        "results": [
            {
                "url": "https://www.threads.net/@renee.diresta/post/DAuthtMxcEJ",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "search operators were not applied",
                "username": "renee.diresta",
                "post_code": "DAuthtMxcEJ"
            },
            {
                "url": "https://www.threads.net/@adam.godigital/post/DGEsEXBhulX",
                "title": null,
                "source": "live_web_search",
                "snippet": "October 5, 2024 -",
                "username": "adam.godigital",
                "post_code": "DGEsEXBhulX"
            },
            {
                "url": "https://www.threads.com/@mikacat1234/post/DGFLE9Dyoca/%E5%BB%A3%E5%91%8A%E6%8A%95%E6%94%BEasc%E5%BB%A3%E5%91%8A%E5%8D%B3%E5%B0%87%E8%B5%B0%E5%85%A5%E6%AD%B7%E5%8F%B2meta-%E5%BB%A3%E5%91%8A%E5%BE%8C%E5%8F%B0%E4%BA%8C%E6%9C%88%E5%8D%B3%E5%B0%87%E6%94%B9%E8%AE%8A%E6%9C%AA%E4%BE%86%E8%A1%8C%E9%8A%B7%E6%B4%BB%E5%8B%95-asc%E8%88%87%E4%B8%80%E8%88%AC%E8%87%AA%E8%A8%82%E5%8F%97%E7%9C%BE%E6%B4%BB%E5%8B%95%E5%B0%87%E5%90%88%E4%BD%B5%E4%B8%8D%E5%86%8D%E5%8D%80%E5%88%86-asc-%E6%88%96%E4%B8%80%E8%88%AC%E9%81%B8%E9%A0%85%E7%B3%BB%E7%B5%B1%E6%9C%83%E9%A0%90%E8%A8%AD%E4%BD%BF%E7%94%A8%E6%9C%80%E4%BD%B3%E5%AF%A6%E4%BD%9C%E6%96%B9%E5%BC%8F%E4%B8%8D",
                "tit
…(truncated, see openapi.json for full schema)
```

### Topics

#### `GET /api/v1/topics/search` — Search topics

Topic-Suche per Volltext.

**Parameters:**
- `query` (query, required, string) — Search text Example: `ai`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/topics/search?query=ai"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.net ai topic",
        "results": [
            {
                "url": "https://www.threads.net/@socialgrowth_ai/post/C-jBSy5NkUS?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "socialgrowth_ai",
                "post_code": "C-jBSy5NkUS"
            },
            {
                "url": "https://www.threads.net/@zuzannapx/post/C56ZeDUoKb5",
                "title": null,
                "source": "live_web_search",
                "snippet": "Join Threads to share ideas, ask questions, post random thoughts, find your people and more. Log in with your Instagram.",
                "username": "zuzannapx",
                "post_code": "C56ZeDUoKb5"
            },
            {
                "url": "https://www.threads.net/@yannlecun/post/DF7j9HNO9L2?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": "April 18, 2024 -",
                "username": "yannlecun",
                "post_code": "DF7j9HNO9L2"
            },
            {
                "url": "https://www.threads.net/@theconversationdotcom/post/DFxrNcCsJJa",
                "title": null,
                "source": "live_web_search",
                "snippet": "301.0K Followers • 1.1K Threads • Professor at NYU Executive Chairman at AMI Labs Researcher in AI & Machine Learning 
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/topics/links` — Topic links

Links aus Topic-Suchergebnissen.

**Parameters:**
- `query` (query, required, string) — Search text Example: `ai`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/topics/links?query=ai"
```

**Response:**
```json
{
    "data": {
        "links": [
            "https://www.threads.net/@socialgrowth_ai/post/C-jBSy5NkUS?hl=en",
            "https://www.threads.net/@zuzannapx/post/C56ZeDUoKb5",
            "https://www.threads.net/@alimirza2k/post/DFkGVvMRXjD",
            "https://www.threads.net/@yannlecun/post/DF7j9HNO9L2?hl=en",
            "https://www.threads.net/@theturingpost/post/DF6VzYDgBz0",
            "https://www.threads.net/@theconversationdotcom/post/DFxrNcCsJJa",
            "https://www.threads.net/@joegermuska/post/DHUmIYPua-4",
            "https://www.threads.net/@perplexity.ai/post/DGD9A69R6FM",
            "https://www.threads.net/@mattnavarra/post/C38Bt_kIeJg?hl=en",
            "https://www.threads.net/@wirol12896/post/DFtjWRINfXj",
            "https://www.threads.net/@saicharan6044/post/DBc1ICbBYh8",
            "https://www.threads.net/@thesocialalpha_/post/DAl27v7iS0c",
            "https://www.threads.net/@chatgpt.prompts.pro/post/DGzUMPGtIEE",
            "https://www.threads.net/@nikkeiasia/post/DH-sGfIo9MP",
            "https://www.threads.net/@the_ainavigator/post/DDh8z8qSLRY"
        ],
        "query": "ai",
        "results": [
            {
                "url": "https://www.threads.net/@socialgrowth_ai/post/C-jBSy5NkUS?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "socialgrowth_ai",
                "post_code": "C-jBSy5NkUS"
            },
 
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/topics/top-result` — Top topic

Bester Topic-Treffer für Query.

**Parameters:**
- `query` (query, required, string) — Search text Example: `ai`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/topics/top-result?query=ai"
```

**Response:**
```json
{
    "data": {
        "query": "ai",
        "result": {
            "url": "https://www.threads.net/@socialgrowth_ai/post/C-jBSy5NkUS?hl=en",
            "title": null,
            "source": "live_web_search",
            "snippet": "Clear filter",
            "username": "socialgrowth_ai",
            "post_code": "C-jBSy5NkUS"
        },
        "live_search_available": true
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:45.278Z",
        "request_id": "c4384d2b-85b0-4133-ac77-f727b2f6836b"
    },
    "status": "ok",
    "message": "Topic top result retrieved successfully",
    "success": true
}
```

### Trending

#### `GET /api/v1/trending/search` — Trending search

Aktuell trendende Such-Begriffe.

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/trending/search"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.com Threads trending today",
        "results": [
            {
                "url": "https://www.threads.com/@whatstrending",
                "title": null,
                "source": "live_web_search",
                "snippet": "Clear filter",
                "username": "whatstrending",
                "post_code": null
            },
            {
                "url": "https://www.threads.com/tag/Trending-Topics",
                "title": null,
                "source": "live_web_search",
                "snippet": "March 2, 2026 -",
                "username": null,
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@threads/post/C4tIdJPOTeJ?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "threads",
                "post_code": "C4tIdJPOTeJ"
            },
            {
                "url": "https://www.threads.com/tag/trending-now",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": null,
                "post_code": null
            },
            {
                "url": "https://www.threads.com/@zuck/post/C4s6IiDL9rW/trending-now-is-rolling-out-to-the-us-today-so-you-can-see-what-people-are-talki?hl=en",
                "title": null,
                "sour
…(truncated, see openapi.json for full schema)
```

#### `GET /api/v1/trending/posts` — Trending posts

Aktuell trendende Posts.

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/trending/posts"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "site:threads.com/@*/post Threads trending today",
        "results": [
            {
                "url": "https://www.threads.com/@threads/post/C4tIdJPOTeJ",
                "title": "search operators",
                "source": "live_web_search",
                "snippet": "Too few matches were found",
                "username": "threads",
                "post_code": "C4tIdJPOTeJ"
            },
            {
                "url": "https://www.threads.com/@zuck/post/C4s6IiDL9rW/trending-now-is-rolling-out-to-the-us-today-so-you-can-see-what-people-are-talki?hl=en",
                "title": null,
                "source": "live_web_search",
                "snippet": "March 19, 2024 -",
                "username": "zuck",
                "post_code": "C4s6IiDL9rW"
            },
            {
                "url": "https://www.threads.com/@buffer/post/DUlS3gKESsI/threads-trending-topics-are-now-live-in-buffer-conversations-on-threads-move",
                "title": null,
                "source": "live_web_search",
                "snippet": null,
                "username": "buffer",
                "post_code": "DUlS3gKESsI"
            },
            {
                "url": "https://www.threads.com/@yusufshid/post/DXp3a5fE3W0/threads-akan-merilis-fitur-baru-trending-now-artinya-tren-dan-berita-terkini",
                "title": null,
                "source": "live_web_search",
                "snippet": null,

…(truncated, see openapi.json for full schema)
```

### Utils

#### `GET /api/v1/utils/username-from-url` — Username from URL

Extrahiert den Username aus einer Threads-Profile-URL.

**Parameters:**
- `url` (query, required, string) — Threads profile URL Example: `https://www.threads.net/@zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/username-from-url?url=https%3A%2F%2Fwww.threads.net%2F%40zuck"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/@zuck",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.162Z",
        "request_id": "ad556eda-6b95-4af2-80b9-ca7a73d2f69c"
    },
    "status": "ok",
    "message": "Username retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/post-code-from-url` — Post code from URL

Extrahiert den Post-Shortcode aus einer Post-URL.

**Parameters:**
- `url` (query, required, string) — Threads post URL Example: `https://www.threads.com/@zuck/post/DPCXhCwkqEe`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/post-code-from-url?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDPCXhCwkqEe"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.com/@zuck/post/DPCXhCwkqEe",
        "code": "DPCXhCwkqEe",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.211Z",
        "request_id": "11689157-c8c3-42c5-bc25-5958f4ce5617"
    },
    "status": "ok",
    "message": "Post code retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/profile-url` — Profile URL

Baut die Profile-URL aus einem Username.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/profile-url?username=zuck"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/@zuck",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.256Z",
        "request_id": "7db50a26-7239-4991-972c-968f07267672"
    },
    "status": "ok",
    "message": "Profile URL retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/threads-net-profile-url` — Threads.net profile URL

Baut die threads.net-Profile-URL.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/threads-net-profile-url?username=zuck"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/@zuck",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.301Z",
        "request_id": "1f6a221c-6a79-4d76-8ddb-4877c02f4024"
    },
    "status": "ok",
    "message": "Threads.net URL retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/threads-com-profile-url` — Threads.com profile URL

Baut die threads.com-Profile-URL.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/threads-com-profile-url?username=zuck"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.com/@zuck",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.374Z",
        "request_id": "7a5a1ac0-fcd8-4aa0-90a0-d0a7bdd7188c"
    },
    "status": "ok",
    "message": "Threads.com URL retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/post-url` — Post URL

Baut die Post-URL aus username + code.

**Parameters:**
- `username` (query, required, string) — Threads username Example: `zuck`
- `code` (query, required, string) — Post shortcode Example: `DPCXhCwkqEe`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/post-url?username=zuck&code=DPCXhCwkqEe"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/@zuck/post/DPCXhCwkqEe",
        "code": "DPCXhCwkqEe",
        "username": "zuck"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.423Z",
        "request_id": "023a0ca2-1818-4a40-bb3b-2aa0c8511ea0"
    },
    "status": "ok",
    "message": "Post URL retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/search-url` — Search URL

Baut die Such-URL für eine Query.

**Parameters:**
- `query` (query, required, string) — Search text Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/search-url?query=meta"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/search?q=meta",
        "query": "meta"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.472Z",
        "request_id": "5ec1ca3b-9d32-432e-b9cd-3498308216b8"
    },
    "status": "ok",
    "message": "Search URL retrieved successfully",
    "success": true
}
```

#### `GET /api/v1/utils/keyword-url` — Keyword URL

Baut die Keyword-URL für ein Schlagwort.

**Parameters:**
- `query` (query, required, string) — Keyword Example: `meta`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/threads-api/api/v1/utils/keyword-url?query=meta"
```

**Response:**
```json
{
    "data": {
        "url": "https://www.threads.net/search?q=meta&serp_type=default",
        "query": "meta"
    },
    "meta": {
        "timestamp": "2026-05-06T22:31:47.518Z",
        "request_id": "91bce2ba-b298-41b7-8f12-fb5363beada9"
    },
    "status": "ok",
    "message": "Keyword URL retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/threads-api
OpenAPI spec: https://www.oanor.com/api/threads-api/openapi.json