AxioAPI
REST API Reference · 80+ Endpoints

API Reference & Developer Documentation

Complete endpoint specifications, request parameters, response schemas, and code samples across all API groups.

Quickstart & Authentication

Authenticate requests with your API key passed in the Authorization Bearer header.

Base URL

https://axioapi.com/api/v1

Authorization Header

+ Get Started Free
Authorization: Bearer YOUR_API_KEY
💡 Headers: Always include Accept: application/json and Content-Type: application/json for POST requests.

SMS

Receive SMS from public test numbers.

GET /api/v1/sms/numbers
0.5 credits / request 30 RPM Studio Test ↗

List SMS numbers

Returns active phone numbers available for receiving one-time SMS verification codes. You can filter by ISO country code.

Request Parameters

Parameter In Type Required Description Example
country query string Optional Two-letter ISO 3166-1 alpha-2 country code (e.g. US, GB, VN, SE). (Default: all) US
page query integer Optional Page number for pagination. (Default: 1) 1
limit query integer Optional Items per page (max 100). (Default: 20) 20
curl -X GET 'https://axioapi.com/api/v1/sms/numbers' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "items": [
            {
                "id": null,
                "countries": "United States",
                "country_code": "US",
                "number": "+12025550192",
                "expiry_date": null,
                "extension_date": null
            },
            {
                "id": null,
                "countries": "United States",
                "country_code": "US",
                "number": "+12025550193",
                "expiry_date": null,
                "extension_date": null
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 20,
            "total": 142,
            "has_more": true
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/sms/numbers",
        "input": []
    }
}
GET /api/v1/sms/numbers/{number}/messages
1 credits / request 20 RPM Studio Test ↗

Get messages for number

Fetches the message stream and latest verification codes received by the specified phone number.

Request Parameters

Parameter In Type Required Description Example
number path string Required E.164 formatted phone number or numeric digits. +12025550192
curl -X GET 'https://axioapi.com/api/v1/sms/numbers/%2B12025550192/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        {
            "sender": "Telegram",
            "message": "Your Telegram code: 492102. Do not share it.",
            "received_at": "2026-10-01T09:12:00Z"
        },
        {
            "sender": "Google",
            "message": "G-829103 is your Google verification code.",
            "received_at": "2026-10-01T09:05:00Z"
        }
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/sms/numbers/{number}/messages",
        "input": {
            "number": "+12025550192"
        }
    }
}
GET /api/v1/sms/messages
1 credits / request 20 RPM Studio Test ↗

List SMS messages

Stream live incoming SMS messages across the platform, with optional filtering by phone number or message source.

Request Parameters

Parameter In Type Required Description Example
number query string Optional Filter by specific phone number. +12025550192
source_id query string Optional Filter by message source identifier. anonymsms
page query integer Optional Pagination page index. (Default: 1) 1
limit query integer Optional Maximum messages to return (max 100). (Default: 20) 20
curl -X GET 'https://axioapi.com/api/v1/sms/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        {
            "number": "+12025550192",
            "sender": "Discord",
            "message": "Your security code is 662910",
            "received_at": "2026-10-01T09:15:00Z"
        }
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/sms/messages",
        "input": []
    }
}

Verify

Authorized phone verification workflow.

POST /api/v1/verify/wait
5 credits / session 10 RPM Studio Test ↗

Wait for verification code

Waits for incoming SMS messages matching an OTP code pattern received after the specified timestamp. Automatically extracts 4-8 digit codes.

Request Parameters

Parameter In Type Required Description Example
number body string Required Target phone number awaiting verification. +12025550192
since body string (ISO 8601) Optional Only consider SMS received after this timestamp. (Default: now() - 5m) 2026-10-01T09:00:00Z
curl -X POST 'https://axioapi.com/api/v1/verify/wait' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"number":"+12025550192","since":"2026-10-01T09:00:00Z"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "code": "739201",
        "sender": "Telegram",
        "full_message": "Your Telegram code: 739201. Do not give this code to anyone.",
        "received_at": "2026-10-01T09:02:14Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/verify/wait",
        "input": {
            "number": "+12025550192"
        }
    }
}

Temporary Email

Stateful temporary inbox operations.

POST /api/v1/temp-mail/inboxes
1 credits / inbox 20 RPM Studio Test ↗

Create inbox

Provisions a new temporary mailbox with customizable lifetime (TTL) and label. Returns an inbox ID and email address ready to receive mail.

Request Parameters

Parameter In Type Required Description Example
label body string Optional Optional label or tag for your own tracking. signup-test
ttl_minutes body integer Optional Inbox lifetime in minutes (5–60); the service may expire it sooner. (Default: 10) 10
curl -X POST 'https://axioapi.com/api/v1/temp-mail/inboxes' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"label":"signup-test","ttl_minutes":10}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "inb_9f8a32b1",
        "address": "[email protected]",
        "expires_at": "2026-10-01T10:30:00Z",
        "created_at": "2026-10-01T09:30:00Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/temp-mail/inboxes",
        "input": []
    }
}
GET /api/v1/temp-mail/inboxes/{inbox}
0.1 credits / poll 30 RPM Studio Test ↗

Get inbox

Checks whether the temporary inbox is active, its expiry time, and total message count.

Request Parameters

Parameter In Type Required Description Example
inbox path string Required Inbox ID returned during creation. inb_9f8a32b1
curl -X GET 'https://axioapi.com/api/v1/temp-mail/inboxes/inb_9f8a32b1' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "inb_9f8a32b1",
        "address": "[email protected]",
        "status": "active",
        "messages_count": 3,
        "expires_at": "2026-10-01T10:30:00Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/temp-mail/inboxes/{inbox}",
        "input": {
            "inbox": "inb_9f8a32b1"
        }
    }
}
GET /api/v1/temp-mail/inboxes/{inbox}/messages
0.1 credits / poll 30 RPM Studio Test ↗

List messages

Returns message summaries (sender, subject, date, read status) for the given inbox ID.

Request Parameters

Parameter In Type Required Description Example
inbox path string Required Inbox ID. inb_9f8a32b1
limit query integer Optional Maximum messages to fetch. (Default: 20) 20
offset query integer Optional Number of messages to skip. (Default: 0) 0
curl -X GET 'https://axioapi.com/api/v1/temp-mail/inboxes/inb_9f8a32b1/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        {
            "id": "msg_01j7abc",
            "from": "[email protected]",
            "subject": "[GitHub] Please verify your email address",
            "snippet": "Your verification code is 840192...",
            "created_at": "2026-10-01T09:32:00Z"
        }
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/temp-mail/inboxes/{inbox}/messages",
        "input": {
            "inbox": "inb_9f8a32b1"
        }
    }
}
GET /api/v1/temp-mail/inboxes/{inbox}/messages/{message}
0.1 credits / poll 30 RPM Studio Test ↗

Get message

Fetches the complete message body, HTML render, plain text, and attachment metadata.

Request Parameters

Parameter In Type Required Description Example
inbox path string Required Inbox ID. inb_9f8a32b1
message path string Required Message ID. msg_01j7abc
curl -X GET 'https://axioapi.com/api/v1/temp-mail/inboxes/inb_9f8a32b1/messages/msg_01j7abc' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "msg_01j7abc",
        "from": "[email protected]",
        "to": "[email protected]",
        "subject": "[GitHub] Please verify your email address",
        "text": "Your verification code is 840192.",
        "html": "<p>Your verification code is <strong>840192</strong>.</p>",
        "received_at": "2026-10-01T09:32:00Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/temp-mail/inboxes/{inbox}/messages/{message}",
        "input": {
            "inbox": "inb_9f8a32b1",
            "message": "msg_01j7abc"
        }
    }
}
POST /api/v1/temp-mail/inboxes/{inbox}/rotate
1 credits / inbox 20 RPM Studio Test ↗

Rotate inbox address

Discards the current address and provisions a fresh address on the same inbox session, keeping inbox history intact.

Request Parameters

Parameter In Type Required Description Example
inbox path string Required Inbox ID to rotate. inb_9f8a32b1
curl -X POST 'https://axioapi.com/api/v1/temp-mail/inboxes/inb_9f8a32b1/rotate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "inb_9f8a32b1",
        "previous_address": "[email protected]",
        "new_address": "[email protected]"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/temp-mail/inboxes/{inbox}/rotate",
        "input": {
            "inbox": "inb_9f8a32b1"
        }
    }
}
DELETE /api/v1/temp-mail/inboxes/{inbox}
Free (0 credits) 20 RPM Studio Test ↗

Delete inbox

Immediately expires and deletes the mailbox and all cached messages. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
inbox path string Required Inbox ID to purge. inb_9f8a32b1
curl -X DELETE 'https://axioapi.com/api/v1/temp-mail/inboxes/inb_9f8a32b1' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
[]

Email Validation

Stateless disposable/format email checks.

POST /api/v1/email/validate
1 credits / email 30 RPM Studio Test ↗

Validate email

Checks syntax, MX records, disposable domain status, and DNS health in under 200ms. Optional consensus mode queries multiple validation engines.

Request Parameters

Parameter In Type Required Description Example
email body string Required The email address to evaluate. [email protected]
consensus body boolean Optional When true, performs additional consistency checks. (Default: false)
curl -X POST 'https://axioapi.com/api/v1/email/validate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","consensus":false}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "email": "[email protected]",
        "valid": true,
        "disposable": false,
        "domain": "stripe.com",
        "syntax_valid": true,
        "mx_records": true,
        "score": 0.98
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/email/validate",
        "input": {
            "email": "[email protected]"
        }
    }
}
POST /api/v1/email/validate-batch
0.6 credits / email 10 RPM Studio Test ↗

Batch validate emails

Fast batch validation with discounted per-email pricing (0.6 credits per email). Returns per-email validity and disposable flags.

Request Parameters

Parameter In Type Required Description Example
emails body array Required Array of valid email address strings (max 100). ["[email protected]","[email protected]"]
curl -X POST 'https://axioapi.com/api/v1/email/validate-batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"emails":["[email protected]","[email protected]"]}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "total": 2,
        "results": [
            {
                "email": "[email protected]",
                "valid": true,
                "disposable": false,
                "score": 0.95
            },
            {
                "email": "[email protected]",
                "valid": false,
                "disposable": true,
                "score": 0.1
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/email/validate-batch",
        "input": {
            "emails": [
                "[email protected]",
                "[email protected]"
            ]
        }
    }
}
POST /api/v1/email/validation-jobs
0.6 credits / email 10 RPM Studio Test ↗

Create validation job

Queues large email lists for asynchronous processing across distributed background workers without HTTP timeouts.

Request Parameters

Parameter In Type Required Description Example
emails body array Required Array of emails (max 1,000 items). ["[email protected]","[email protected]"]
consensus body boolean Optional Enable additional consistency checks. (Default: false)
curl -X POST 'https://axioapi.com/api/v1/email/validation-jobs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"emails":["[email protected]","[email protected]"],"consensus":false}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "job_id": "job_01j7abcde987654321",
        "status": "processing",
        "total_emails": 250,
        "created_at": "2026-10-01T09:35:00Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/email/validation-jobs",
        "input": {
            "emails": [
                "[email protected]",
                "[email protected]"
            ]
        }
    }
}
GET /api/v1/email/validation-jobs/{job}
Free (0 credits) 60 RPM Studio Test ↗

Get validation job

Polls job status (processing/completed) and fetches paginated validation results with summary metrics. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
job path string Required Job ID returned by creation. job_01j7abcde987654321
page query integer Optional Result page number. (Default: 1) 1
per_page query integer Optional Items per page (max 100). (Default: 50) 50
curl -X GET 'https://axioapi.com/api/v1/email/validation-jobs/job_01j7abcde987654321' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "job_id": "job_01j7abcde987654321",
        "status": "completed",
        "progress": 100,
        "total": 250,
        "valid_count": 210,
        "disposable_count": 40,
        "results": [
            {
                "email": "[email protected]",
                "valid": true,
                "disposable": false
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/email/validation-jobs/{job}",
        "input": {
            "job": "job_01j7abcde987654321"
        }
    }
}

SEO & Keywords

Search volume, CPC and autocomplete keywords intelligence.

POST /api/v1/seo/keywords/metrics
2 credits / request 20 RPM Studio Test ↗

Keyword metrics

Returns monthly average search volumes, cost-per-click (CPC in USD), and keyword difficulty metrics across Google search data.

Request Parameters

Parameter In Type Required Description Example
keywords body array Required List of keyword phrases to analyze. ["api gateway","proxy scraper"]
country body string Optional Target market country code (us, vn, uk, sg...). (Default: us) us
curl -X POST 'https://axioapi.com/api/v1/seo/keywords/metrics' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["api gateway","proxy scraper"],"country":"us"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        {
            "keyword": "api gateway",
            "search_volume": 33100,
            "cpc": 4.25,
            "competition": 0.65,
            "currency": "USD"
        },
        {
            "keyword": "proxy scraper",
            "search_volume": 8100,
            "cpc": 1.8,
            "competition": 0.42,
            "currency": "USD"
        }
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/seo/keywords/metrics",
        "input": {
            "keywords": [
                "api gateway",
                "proxy scraper"
            ]
        }
    }
}
GET /api/v1/seo/keywords/suggestions
1 credits / request 30 RPM Studio Test ↗

Keyword suggestions

Retrieves real-time user search queries matching the prefix query, language, and country.

Request Parameters

Parameter In Type Required Description Example
q query string Required Search prefix string. laravel api
country query string Optional Country code. (Default: us) us
lang query string Optional Language code. (Default: en) en
curl -X GET 'https://axioapi.com/api/v1/seo/keywords/suggestions?q=laravel+api' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        "laravel api authentication",
        "laravel api resource tutorial",
        "laravel api rate limiting",
        "laravel api token sanctum"
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/seo/keywords/suggestions",
        "input": {
            "q": "laravel api"
        }
    }
}
POST /api/v1/seo/keywords/ideas
2 credits / request 20 RPM Studio Test ↗

Keyword ideas

Expands a seed keyword into high-potential long-tail keyword suggestions with estimated monthly volumes.

Request Parameters

Parameter In Type Required Description Example
keyword body string Required Seed keyword to expand. web scraping
country body string Optional Country code. (Default: us) us
curl -X POST 'https://axioapi.com/api/v1/seo/keywords/ideas' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"web scraping","country":"us"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "seed": "web scraping",
        "ideas": [
            {
                "keyword": "web scraping python tutorial",
                "search_volume": 14800,
                "difficulty": 45
            },
            {
                "keyword": "web scraping tools 2026",
                "search_volume": 6600,
                "difficulty": 38
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/seo/keywords/ideas",
        "input": {
            "keyword": "web scraping"
        }
    }
}
GET /api/v1/seo/domains/{domain}
5 credits / request 20 RPM Studio Test ↗

Domain overview

Returns domain organic monthly traffic, indexed keywords count, Semrush authority score, and backlinks profile.

Request Parameters

Parameter In Type Required Description Example
domain path string Required Domain hostname (without http/https). github.com
country query string Optional Target country database. (Default: us) us
curl -X GET 'https://axioapi.com/api/v1/seo/domains/github.com' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "domain": "github.com",
        "organic_traffic": 142000000,
        "organic_keywords": 8500000,
        "authority_score": 96,
        "backlinks_count": 420000000
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/seo/domains/{domain}",
        "input": {
            "domain": "github.com"
        }
    }
}
GET /api/v1/seo/domains/{domain}/history
5 credits / request 10 RPM Studio Test ↗

Domain history

Provides historical time-series data of organic visitors and ranking keywords up to 36 months.

Request Parameters

Parameter In Type Required Description Example
domain path string Required Domain hostname. github.com
months query integer Optional Number of historical months to retrieve (max 36). (Default: 12) 12
curl -X GET 'https://axioapi.com/api/v1/seo/domains/github.com/history' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "domain": "github.com",
        "history": [
            {
                "date": "2026-08",
                "organic_traffic": 139000000,
                "keywords": 8400000
            },
            {
                "date": "2026-09",
                "organic_traffic": 142000000,
                "keywords": 8500000
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/seo/domains/{domain}/history",
        "input": {
            "domain": "github.com"
        }
    }
}
POST /api/v1/seo/on-page-audit
2 credits / request 10 RPM Studio Test ↗

On-page audit

Scans a webpage URL for title tags, meta description, heading structure (H1/H2), SSL validity, load latency, and critical technical warnings.

Request Parameters

Parameter In Type Required Description Example
url body string Required Full webpage URL including protocol (https://). https://example.com
curl -X POST 'https://axioapi.com/api/v1/seo/on-page-audit' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "url": "https://example.com",
        "status_code": 200,
        "title": "Example Domain",
        "h1": [
            "Example Domain"
        ],
        "meta_description": null,
        "load_time_ms": 145,
        "ssl_valid": true,
        "issues": [
            {
                "type": "warning",
                "code": "missing_meta_description",
                "message": "Missing meta description tag."
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/seo/on-page-audit",
        "input": {
            "url": "https://example.com"
        }
    }
}

Content & Text Processing

AI text generation, grammar checking, and YouTube transcripts.

POST /api/v1/grammar/check
1 credits / request 30 RPM Studio Test ↗

Grammar check

Analyzes text for grammatical errors, typos, and phrasing improvements using LanguageTool.

Request Parameters

Parameter In Type Required Description Example
text body string Required Raw text snippet to check. He go to school yesterday.
language body string Optional Language code (e.g. en-US, vi, fr, de). (Default: en-US) en-US
curl -X POST 'https://axioapi.com/api/v1/grammar/check' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"text":"He go to school yesterday.","language":"en-US"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "matches": [
            {
                "message": "Did you mean 'went'?",
                "offset": 3,
                "length": 2,
                "replacements": [
                    "went"
                ],
                "rule": "PAST_TENSE"
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/grammar/check",
        "input": {
            "text": "He go to school yesterday."
        }
    }
}
POST /api/v1/text/generate
2 credits / request 20 RPM Studio Test ↗

Text generate

Produces fluent text responses, summaries, or structured copy using high-performance LLM engines.

Request Parameters

Parameter In Type Required Description Example
prompt body string Required Instruction prompt for text generation. Summarize microservices benefits in 3 concise bullet points.
max_tokens body integer Optional -
temperature body number Optional -
model body string Optional -
curl -X POST 'https://axioapi.com/api/v1/text/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"Summarize microservices benefits in 3 concise bullet points."}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "text": "• Independent deployability enables rapid release cycles.\n• Fault isolation prevents total application downtime.\n• Tech-stack flexibility fits heterogeneous service requirements.",
        "word_count": 26
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/text/generate",
        "input": {
            "prompt": "Summarize microservices benefits in 3 concise bullet points."
        }
    }
}
GET /api/v1/videos/{video}/transcript
1.5 credits / request 20 RPM Studio Test ↗

Video transcript

Extracts subtitles/closed captions from public YouTube videos with start times and durations.

Request Parameters

Parameter In Type Required Description Example
video path string Required 11-character YouTube video ID. dQw4w9WgXcQ
lang query string Optional Preferred transcript language code. (Default: en) en
curl -X GET 'https://axioapi.com/api/v1/videos/dQw4w9WgXcQ/transcript' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "video_id": "dQw4w9WgXcQ",
        "language": "en",
        "segments": [
            {
                "start": 0,
                "duration": 3.5,
                "text": "We're no strangers to love"
            },
            {
                "start": 3.6,
                "duration": 4,
                "text": "You know the rules and so do I"
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/videos/{video}/transcript",
        "input": {
            "video": "dQw4w9WgXcQ"
        }
    }
}
GET /api/v1/videos/{video}/tags
0.5 credits / request 30 RPM Studio Test ↗

Video tags

Inspects hidden creator tags and keywords assigned to a YouTube video.

Request Parameters

Parameter In Type Required Description Example
video path string Required YouTube video ID. dQw4w9WgXcQ
lang query string Optional -
curl -X GET 'https://axioapi.com/api/v1/videos/dQw4w9WgXcQ/tags' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "video_id": "dQw4w9WgXcQ",
        "title": "Rick Astley - Never Gonna Give You Up",
        "tags": [
            "rick astley",
            "pop",
            "80s music",
            "music video"
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/videos/{video}/tags",
        "input": {
            "video": "dQw4w9WgXcQ"
        }
    }
}
GET /api/v1/content/prompts/topics
0.1 credits / request 30 RPM Studio Test ↗

List AI prompt topics catalog

Provides vetted prompt recipes across marketing, development, SEO, and copywriting.

Request Parameters

Parameter In Type Required Description Example
q query string Optional Optional filter query. SEO
curl -X GET 'https://axioapi.com/api/v1/content/prompts/topics' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "topics": [
            {
                "category": "SEO",
                "templates": [
                    "Write an SEO-optimized meta description for {topic}"
                ]
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/content/prompts/topics",
        "input": []
    }
}
POST /api/v1/audio/tts
5 credits / char1k 20 RPM Studio Test ↗

Text to speech synthesis

This request returns the generated result and a resource ID. Use the ID to read the stored result or retrieve its artifact.

Request Parameters

Parameter In Type Required Description Example
text body string Required Text to read aloud. Welcome to AxioAPI.
voice body string Optional Voice identifier from voices catalog. (Default: en-US-Standard-C) en-US-Standard-C
curl -X POST 'https://axioapi.com/api/v1/audio/tts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"text":"Welcome to AxioAPI.","voice":"en-US-Standard-C"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "RESOURCE_ID",
        "status": "succeeded"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/audio/tts",
        "input": {
            "text": "Welcome to AxioAPI."
        }
    }
}
GET /api/v1/audio/tts/{job}
Free (0 credits) 30 RPM Studio Test ↗

Get audio TTS job status

Returns current rendering status (processing/completed) and artifact download URL. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
job path string Required Job ID. tts_01j7abcde44332211
curl -X GET 'https://axioapi.com/api/v1/audio/tts/tts_01j7abcde44332211' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "job_id": "tts_01j7abcde44332211",
        "status": "completed",
        "download_url": "/api/v1/audio/tts/tts_01j7abcde44332211/artifact"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/audio/tts/{job}",
        "input": {
            "job": "tts_01j7abcde44332211"
        }
    }
}
GET /api/v1/audio/tts/{job}/artifact
Free (0 credits) 30 RPM Studio Test ↗

Download audio artifact

Streams binary audio file with Content-Type: audio/mpeg.

Request Parameters

Parameter In Type Required Description Example
job path string Required Completed job ID. tts_01j7abcde44332211
curl -X GET 'https://axioapi.com/api/v1/audio/tts/tts_01j7abcde44332211/artifact' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' --output artifact.bin
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "[Binary MP3 Audio Stream]": "Content-Type: audio/mpeg"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/audio/tts/{job}/artifact",
        "input": {
            "job": "tts_01j7abcde44332211"
        }
    }
}
DELETE /api/v1/audio/tts/{job}
Free (0 credits) 30 RPM Studio Test ↗

Cancel audio job and purge state

Aborts rendering and frees storage immediately.

Request Parameters

Parameter In Type Required Description Example
job path string Required Job ID to cancel. tts_01j7abcde44332211
curl -X DELETE 'https://axioapi.com/api/v1/audio/tts/tts_01j7abcde44332211' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "cancelled": true,
        "job_id": "tts_01j7abcde44332211"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "DELETE",
        "path": "/api/v1/audio/tts/{job}",
        "input": {
            "job": "tts_01j7abcde44332211"
        }
    }
}
GET /api/v1/tts/voices
0.1 credits / request 30 RPM Studio Test ↗

List TTS voices catalog

Returns available text-to-speech voices with gender, accent, and language tags.

Request Parameters

Parameter In Type Required Description Example
category query string Optional Filter by voice tier or language. standard
curl -X GET 'https://axioapi.com/api/v1/tts/voices' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "voices": [
            {
                "id": "en-US-Standard-C",
                "name": "English (US) Female",
                "language": "en-US",
                "gender": "FEMALE"
            },
            {
                "id": "vi-VN-Standard-A",
                "name": "Vietnamese Female",
                "language": "vi-VN",
                "gender": "FEMALE"
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/tts/voices",
        "input": []
    }
}

AI Visual Generation

Text-to-image and graphic generation.

POST /api/v1/ai/images
8 credits / image 10 RPM Studio Test ↗

AI image generate

This request returns the generated result and a resource ID. Use the ID to read the stored result or retrieve its artifact.

Request Parameters

Parameter In Type Required Description Example
prompt body string Required Detailed scene description. Futuristic cyber server room with neon cables, isometric 3D render
width body integer Optional Image width in pixels (e.g. 512, 768, 1024). (Default: 1024) 1024
height body integer Optional Image height in pixels. (Default: 1024) 1024
samples body integer Optional -
curl -X POST 'https://axioapi.com/api/v1/ai/images' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"Futuristic cyber server room with neon cables, isometric 3D render","width":1024,"height":1024}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "RESOURCE_ID",
        "status": "succeeded"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/ai/images",
        "input": {
            "prompt": "Futuristic cyber server room with neon cables, isometric 3D render"
        }
    }
}
POST /api/v1/ai/images/edit
8 credits / image 10 RPM Studio Test ↗

Edit or modify AI image

This request returns the generated result and a resource ID. Use the ID to read the stored result or retrieve its artifact.

Request Parameters

Parameter In Type Required Description Example
prompt body string Required Editing instructions. Change background to sunset beach
image_url body string Optional Source image URL. https://example.com/source.jpg
job_id body string Optional Previous generation job ID. img_01j7abcde55443322
image body string Optional -
width body integer Optional -
height body integer Optional -
curl -X POST 'https://axioapi.com/api/v1/ai/images/edit' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"Change background to sunset beach","image_url":"https://example.com/source.jpg","job_id":"img_01j7abcde55443322"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "RESOURCE_ID",
        "status": "succeeded"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/ai/images/edit",
        "input": {
            "prompt": "Change background to sunset beach"
        }
    }
}
GET /api/v1/ai/images/{job}
Free (0 credits) 30 RPM Studio Test ↗

Get AI image job status

Checks if the diffusion job is completed and returns the artifact URL. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
job path string Required Job ID. img_01j7abcde55443322
curl -X GET 'https://axioapi.com/api/v1/ai/images/img_01j7abcde55443322' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "job_id": "img_01j7abcde55443322",
        "status": "completed",
        "download_url": "/api/v1/ai/images/img_01j7abcde55443322/artifact"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/ai/images/{job}",
        "input": {
            "job": "img_01j7abcde55443322"
        }
    }
}
GET /api/v1/ai/images/{job}/artifact
Free (0 credits) 30 RPM Studio Test ↗

Download validated AI image artifact

Returns binary image data with appropriate image/png or image/jpeg headers.

Request Parameters

Parameter In Type Required Description Example
job path string Required Completed job ID. img_01j7abcde55443322
curl -X GET 'https://axioapi.com/api/v1/ai/images/img_01j7abcde55443322/artifact' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' --output artifact.bin
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "[Binary Image Data]": "Content-Type: image/png"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/ai/images/{job}/artifact",
        "input": {
            "job": "img_01j7abcde55443322"
        }
    }
}
DELETE /api/v1/ai/images/{job}
Free (0 credits) 30 RPM Studio Test ↗

Cancel AI image job and purge state

Terminates diffusion execution and releases image cache.

Request Parameters

Parameter In Type Required Description Example
job path string Required Job ID to terminate. img_01j7abcde55443322
curl -X DELETE 'https://axioapi.com/api/v1/ai/images/img_01j7abcde55443322' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "cancelled": true,
        "job_id": "img_01j7abcde55443322"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "DELETE",
        "path": "/api/v1/ai/images/{job}",
        "input": {
            "job": "img_01j7abcde55443322"
        }
    }
}

Utility

BIN lookup, coupons và các tra cứu tiện ích.

GET /api/v1/bin/{bin}
0.5 credits / request 30 RPM Studio Test ↗

BIN lookup

Extracts card issuing network (Visa, Mastercard, Amex), card type (debit, credit), issuer bank name, and country code from the first 6-8 digits.

Request Parameters

Parameter In Type Required Description Example
bin path string Required First 6 to 8 digits of a payment card. 453211
curl -X GET 'https://axioapi.com/api/v1/bin/453211' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "bin": "453211",
        "scheme": "visa",
        "type": "debit",
        "brand": "Traditional",
        "country": {
            "name": "United States",
            "code": "US",
            "currency": "USD"
        },
        "bank": {
            "name": "JPMorgan Chase Bank, N.A."
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/bin/{bin}",
        "input": {
            "bin": "453211"
        }
    }
}
GET /api/v1/dns/{domain}
0.5 credits / request 60 RPM Studio Test ↗

DNS resolve

Queries authoritative DNS nameservers for specified record types with TTL values.

Request Parameters

Parameter In Type Required Description Example
domain path string Required Domain hostname. cloudflare.com
type query string Required Record type: A, AAAA, MX, TXT, NS, CNAME. (Default: A) A
curl -X GET 'https://axioapi.com/api/v1/dns/cloudflare.com?type=A' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "domain": "cloudflare.com",
        "type": "A",
        "records": [
            {
                "ip": "104.16.132.229",
                "ttl": 300
            },
            {
                "ip": "104.16.133.229",
                "ttl": 300
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/dns/{domain}",
        "input": {
            "domain": "cloudflare.com",
            "type": "A"
        }
    }
}
GET /api/v1/tech/{domain}
1 credits / request 30 RPM Studio Test ↗

Technology profile

Inspects HTTP response headers, meta generators, and script fingerprints to identify web stacks (e.g. Laravel, WordPress, Tailwind, Nginx).

Request Parameters

Parameter In Type Required Description Example
domain path string Required Domain name or website URL. laravel.com
url query string Optional -
curl -X GET 'https://axioapi.com/api/v1/tech/laravel.com' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "domain": "laravel.com",
        "technologies": [
            {
                "name": "Laravel",
                "category": "Web Frameworks"
            },
            {
                "name": "Tailwind CSS",
                "category": "UI Frameworks"
            },
            {
                "name": "Nginx",
                "category": "Web Servers"
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/tech/{domain}",
        "input": {
            "domain": "laravel.com"
        }
    }
}

Proxy & VPN Nodes

Residential & datacenter proxy nodes and sessions.

GET /api/v1/proxy/locations
0.1 credits / request 30 RPM Studio Test ↗

List proxy locations

Returns active proxy exit locations, protocol support (HTTP, HTTPS, SOCKS5), and available node counts.

Request Parameters

Parameter In Type Required Description Example
country query string Optional Filter by country code. US
region query string Optional -
curl -X GET 'https://axioapi.com/api/v1/proxy/locations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "locations": [
            {
                "country": "US",
                "name": "United States",
                "available_nodes": 450,
                "protocols": [
                    "http",
                    "socks5"
                ]
            },
            {
                "country": "VN",
                "name": "Vietnam",
                "available_nodes": 120,
                "protocols": [
                    "http",
                    "socks5"
                ]
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/proxy/locations",
        "input": []
    }
}
POST /api/v1/proxy/sessions
2 credits / session 20 RPM Studio Test ↗

Create proxy session

Allocates a dedicated proxy session with hostname, port, username, and password credentials.

Request Parameters

Parameter In Type Required Description Example
country body string Optional Target exit country code. (Default: random) US
protocol body string Optional Protocol: http, socks5. (Default: http) http
region body string Optional -
mode body string Optional -
curl -X POST 'https://axioapi.com/api/v1/proxy/sessions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"country":"US","protocol":"http"}'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "session_id": "prx_01j7abcde11223344",
        "host": "proxy.axioapi.com",
        "port": 10001,
        "username": "usr_789012",
        "password": "sec_987654321",
        "protocol": "http",
        "country": "US",
        "ip": "198.51.100.45",
        "expires_at": "2026-10-01T11:00:00Z"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/proxy/sessions",
        "input": []
    }
}
GET /api/v1/proxy/sessions/{session}
Free (0 credits) 30 RPM Studio Test ↗

Get proxy session

Checks connection health, outgoing IP, and transferred bytes for a session. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
session path string Required Proxy session ID. prx_01j7abcde11223344
curl -X GET 'https://axioapi.com/api/v1/proxy/sessions/prx_01j7abcde11223344' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "session_id": "prx_01j7abcde11223344",
        "ip": "198.51.100.45",
        "status": "active",
        "bytes_transferred": 2097152
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/proxy/sessions/{session}",
        "input": {
            "session": "prx_01j7abcde11223344"
        }
    }
}
POST /api/v1/proxy/sessions/{session}/rotate
1 credits / request 20 RPM Studio Test ↗

Rotate proxy node

Instantly rotates the underlying IP address while keeping the same session credentials.

Request Parameters

Parameter In Type Required Description Example
session path string Required Proxy session ID to rotate. prx_01j7abcde11223344
curl -X POST 'https://axioapi.com/api/v1/proxy/sessions/prx_01j7abcde11223344/rotate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "session_id": "prx_01j7abcde11223344",
        "new_ip": "203.0.113.88",
        "country": "US"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "POST",
        "path": "/api/v1/proxy/sessions/{session}/rotate",
        "input": {
            "session": "prx_01j7abcde11223344"
        }
    }
}
DELETE /api/v1/proxy/sessions/{session}
Free (0 credits) 20 RPM Studio Test ↗

Close proxy session

Terminates the tunnel immediately. Cost: Free (0 credits).

Request Parameters

Parameter In Type Required Description Example
session path string Required Proxy session ID to close. prx_01j7abcde11223344
curl -X DELETE 'https://axioapi.com/api/v1/proxy/sessions/prx_01j7abcde11223344' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "closed": true,
        "session_id": "prx_01j7abcde11223344"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "DELETE",
        "path": "/api/v1/proxy/sessions/{session}",
        "input": {
            "session": "prx_01j7abcde11223344"
        }
    }
}

TikTok Scraper

TikTok creator profiles, watermark-free HD video downloads, and comments.

GET /api/v1/social/tiktok/profile
1.5 credits / request 20 RPM Studio Test ↗

TikTok creator profile & stats

Returns creator nickname, follower count, total likes, video count, and signature.

Request Parameters

Parameter In Type Required Description Example
handle query string Required -
fresh query boolean Optional -
curl -X GET 'https://axioapi.com/api/v1/social/tiktok/profile?handle=value' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "username": "tiktok",
        "nickname": "TikTok",
        "follower_count": 82000000,
        "heart_count": 320000000,
        "verified": true,
        "signature": "Make Your Day"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/tiktok/profile",
        "input": []
    }
}
GET /api/v1/social/tiktok/video
1 credits / request 20 RPM Studio Test ↗

TikTok video metadata

Metadata and stats of a TikTok video, with the no-watermark file link.

Request Parameters

Parameter In Type Required Description Example
url query string Required Full TikTok video URL. https://www.tiktok.com/@tiktok/video/6584647400055377158
curl -X GET 'https://axioapi.com/api/v1/social/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F6584647400055377158' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "tiktok",
        "type": "video",
        "id": "6584647400055377158",
        "url": "https://www.tiktok.com/@tiktok/video/6584647400055377158",
        "title": "#MakeEverySecondCount",
        "text": null,
        "author": {
            "name": "TikTok",
            "url": "https://www.tiktok.com/@tiktok"
        },
        "thumbnail_url": "https://p16-common-sign.tiktokcdn-us.com/cover.jpeg",
        "published_at": "2018-08-02T10:00:00Z",
        "stats": {
            "views": 12000000,
            "likes": 900000,
            "dislikes": null,
            "replies": 20000,
            "shares": 15000,
            "rating": null
        },
        "extra": {
            "duration_seconds": 15,
            "video_url": "https://…/play.mp4",
            "video_hd_url": "https://…/hd.mp4",
            "music": "original sound",
            "size_bytes": 2100000
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/tiktok/video",
        "input": {
            "url": "https://www.tiktok.com/@tiktok/video/6584647400055377158"
        }
    }
}
GET /api/v1/social/tiktok/comments
1 credits / request 20 RPM Studio Test ↗

TikTok video comments

Comments of a TikTok video with like and reply counts; pass query.next_cursor back as cursor for the next page.

Request Parameters

Parameter In Type Required Description Example
url query string Required Full TikTok video URL. https://www.tiktok.com/@tiktok/video/6584647400055377158
limit query integer Optional Comments per page (1-50). (Default: 10) 20
cursor query integer Optional Offset from the previous page. (Default: 0) 0
curl -X GET 'https://axioapi.com/api/v1/social/tiktok/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F6584647400055377158' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "tiktok",
        "type": "feed",
        "kind": "comments",
        "query": {
            "url": "https://www.tiktok.com/@tiktok/video/6584647400055377158",
            "total_comments": 5717,
            "next_cursor": 20
        },
        "total": 1,
        "items": [
            {
                "platform": "tiktok",
                "type": "comment",
                "id": "77",
                "url": null,
                "title": null,
                "text": "nice",
                "author": {
                    "name": "Fan",
                    "url": "https://www.tiktok.com/@fan"
                },
                "thumbnail_url": null,
                "published_at": "2018-08-02T10:00:00Z",
                "stats": {
                    "views": null,
                    "likes": 9,
                    "dislikes": null,
                    "replies": 2,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "depth": 0
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/tiktok/comments",
        "input": {
            "url": "https://www.tiktok.com/@tiktok/video/6584647400055377158"
        }
    }
}
GET /api/v1/social/tiktok/feed
1 credits / request 20 RPM Studio Test ↗

TikTok trending feed

Trending TikTok videos of a region.

Request Parameters

Parameter In Type Required Description Example
region query string Optional Two-letter country code. VN
limit query integer Optional Maximum items (1-50). 20
curl -X GET 'https://axioapi.com/api/v1/social/tiktok/feed' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "tiktok",
        "type": "feed",
        "kind": "trending",
        "query": {
            "region": "VN"
        },
        "total": 1,
        "items": [
            {
                "platform": "tiktok",
                "type": "video",
                "id": "6584647400055377158",
                "url": null,
                "title": "Trend",
                "text": null,
                "author": {
                    "name": null,
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "duration_seconds": 15,
                    "video_url": "https://cdn/p.mp4",
                    "music_url": null
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/tiktok/feed",
        "input": []
    }
}

Facebook Scraper

Public Facebook Fanpage intelligence, posts feed, and numeric UID lookup.

GET /api/v1/social/facebook/page
1 credits / request 30 RPM Studio Test ↗

Facebook page intelligence

Extracts public fanpage identity, follower count, likes, website, and verification status.

Request Parameters

Parameter In Type Required Description Example
page query string Required -
fresh query boolean Optional -
curl -X GET 'https://axioapi.com/api/v1/social/facebook/page?page=value' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "100054321",
        "name": "Meta",
        "likes": 78000000,
        "followers": 82000000,
        "category": "Technology Company",
        "verified": true
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/facebook/page",
        "input": []
    }
}
GET /api/v1/social/facebook/uid
0.5 credits / request 30 RPM Studio Test ↗

Facebook numeric UID lookup

Converts any Facebook profile or group URL into its permanent numeric ID.

Request Parameters

Parameter In Type Required Description Example
url query string Required Facebook profile or page URL. https://www.facebook.com/zuck
curl -X GET 'https://axioapi.com/api/v1/social/facebook/uid?url=https%3A%2F%2Fwww.facebook.com%2Fzuck' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "uid": "4",
        "url": "https://www.facebook.com/zuck"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/facebook/uid",
        "input": {
            "url": "https://www.facebook.com/zuck"
        }
    }
}
GET /api/v1/social/facebook/pages/{page}/posts
1.5 credits / request 10 RPM Studio Test ↗

Facebook page latest posts

Text of the latest public posts of a Facebook page, read without a login. Facebook may serve a trimmed page, so the count varies.

Request Parameters

Parameter In Type Required Description Example
page path string Required Page slug. nasa
limit query integer Optional Maximum posts (1-50). (Default: 10) 20
curl -X GET 'https://axioapi.com/api/v1/social/facebook/pages/nasa/posts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "facebook",
        "type": "feed",
        "kind": "page-posts",
        "query": {
            "page": "nasa"
        },
        "total": 1,
        "items": [
            {
                "platform": "facebook",
                "type": "post",
                "id": null,
                "url": null,
                "title": null,
                "text": "Launch day!",
                "author": {
                    "name": "nasa",
                    "url": "https://www.facebook.com/nasa"
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": []
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/facebook/pages/{page}/posts",
        "input": {
            "page": "nasa"
        }
    }
}
GET /api/v1/social/facebook/ads
2 credits / request 10 RPM Studio Test ↗

Facebook Ad Library search

Search the Meta Ad Library: advertiser, copy, creatives, platforms and run dates.

Request Parameters

Parameter In Type Required Description Example
q query string Required Search keywords. nike
country query string Optional Two-letter country code or ALL (default US). US
status query string Optional ACTIVE, INACTIVE or ALL. ACTIVE
limit query integer Optional Maximum items (1-50). 20
cursor query string Optional query.next_cursor of the previous page. AQHT...
curl -X GET 'https://axioapi.com/api/v1/social/facebook/ads?q=nike' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "facebook",
        "type": "feed",
        "kind": "ads",
        "query": {
            "q": "nike",
            "country": "US",
            "next_cursor": "AQHT..."
        },
        "total": 1,
        "items": [
            {
                "platform": "facebook",
                "type": "ad",
                "id": "1550534860016399",
                "url": "https://www.facebook.com/ads/library/?id=1550534860016399",
                "title": null,
                "text": "Ad copy",
                "author": {
                    "name": "Advertiser",
                    "url": "https://www.facebook.com/100093512920259/"
                },
                "thumbnail_url": null,
                "published_at": "2026-05-19T07:00:00Z",
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "page_id": "115939511520844",
                    "is_active": true,
                    "end_date": null,
                    "platforms": [
                        "FACEBOOK",
                        "INSTAGRAM"
                    ],
                    "cta_text": "Install now",
                    "link_url": "https://example.com",
                    "display_format": "IMAGE",
                    "images": [
                        "https://scontent.fbcdn.net/a.jpg"
                    ],
                    "videos": []
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/facebook/ads",
        "input": {
            "q": "nike"
        }
    }
}
GET /api/v1/social/facebook/videos/{id}
1 credits / request 20 RPM Studio Test ↗

Facebook video / reel HD link

Direct MP4 links of a public Facebook video or reel by numeric id.

Request Parameters

Parameter In Type Required Description Example
id path string Required Numeric video id. 1234567890123
curl -X GET 'https://axioapi.com/api/v1/social/facebook/videos/1234567890123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "facebook",
        "type": "video",
        "id": "1234567890123",
        "url": "https://www.facebook.com/watch/?v=1234567890123",
        "title": "Sample",
        "text": null,
        "author": {
            "name": null,
            "url": null
        },
        "thumbnail_url": null,
        "published_at": null,
        "stats": {
            "views": null,
            "likes": null,
            "dislikes": null,
            "replies": null,
            "shares": null,
            "rating": null
        },
        "extra": {
            "video_hd_url": "https://video.fbcdn.net/hd.mp4",
            "video_sd_url": "https://video.fbcdn.net/sd.mp4"
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/facebook/videos/{id}",
        "input": {
            "id": "1234567890123"
        }
    }
}

Instagram Scraper

Instagram public profiles, post/reel details with 1080p media and engagement.

GET /api/v1/social/instagram/profiles/{username}
1.5 credits / request 20 RPM Studio Test ↗

Instagram public profile

Public Instagram profile read without a login. Fails with a retryable error when Instagram shows a login wall.

Request Parameters

Parameter In Type Required Description Example
username path string Required Instagram username. natgeo
curl -X GET 'https://axioapi.com/api/v1/social/instagram/profiles/natgeo' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "instagram",
        "type": "profile",
        "id": null,
        "username": "natgeo",
        "display_name": "National Geographic",
        "headline": null,
        "description": null,
        "url": "https://www.instagram.com/natgeo/",
        "avatar_url": "https://scontent.cdninstagram.com/a.jpg",
        "banner_url": null,
        "location": null,
        "followers": 268000000,
        "following": 195,
        "posts_count": 32000,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": []
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/instagram/profiles/{username}",
        "input": {
            "username": "natgeo"
        }
    }
}
GET /api/v1/social/instagram/posts/{code}
1 credits / request 20 RPM Studio Test ↗

Instagram post / reel detail

Public Instagram post or reel by shortcode, with caption, likes, comments, image and (for reels) video link.

Request Parameters

Parameter In Type Required Description Example
code path string Required Post shortcode from the /p/ or /reel/ URL. C0abcDEF12
curl -X GET 'https://axioapi.com/api/v1/social/instagram/posts/C0abcDEF12' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "instagram",
        "type": "video",
        "id": "C0abcDEF12",
        "url": "https://www.instagram.com/p/C0abcDEF12/",
        "title": null,
        "text": "Look up!",
        "author": {
            "name": "nasa",
            "url": "https://www.instagram.com/nasa/"
        },
        "thumbnail_url": "https://scontent.cdninstagram.com/p.jpg",
        "published_at": null,
        "stats": {
            "views": null,
            "likes": 1000000,
            "dislikes": null,
            "replies": 7177,
            "shares": null,
            "rating": null
        },
        "extra": {
            "image_url": "https://scontent.cdninstagram.com/p.jpg",
            "video_url": "https://scontent.cdninstagram.com/p.mp4"
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/instagram/posts/{code}",
        "input": {
            "code": "C0abcDEF12"
        }
    }
}

YouTube Scraper

Zero-quota YouTube video downloads, channel latest videos, stats and hidden dislikes.

GET /api/v1/social/youtube/videos/{id}/stats
0.5 credits / request 30 RPM Studio Test ↗

YouTube video engagement & dislikes

Provides engagement metrics including restored dislike counts via the Return YouTube Dislike API.

Request Parameters

Parameter In Type Required Description Example
id path string Required YouTube 11-char video ID. dQw4w9WgXcQ
curl -X GET 'https://axioapi.com/api/v1/social/youtube/videos/dQw4w9WgXcQ/stats' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "dQw4w9WgXcQ",
        "view_count": 1560000000,
        "like_count": 17000000,
        "dislike_count": 420000,
        "comment_count": 2500000,
        "rating": 4.9
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/videos/{id}/stats",
        "input": {
            "id": "dQw4w9WgXcQ"
        }
    }
}
GET /api/v1/social/youtube/channels/{channel}/videos
0.5 credits / request 30 RPM Studio Test ↗

YouTube channel latest videos

Latest videos of a YouTube channel (RSS, no API quota).

Request Parameters

Parameter In Type Required Description Example
channel path string Required Channel ID (starts with UC). UC_x5XG1OV2P6uZZ5FSM9Ttw
curl -X GET 'https://axioapi.com/api/v1/social/youtube/channels/UC_x5XG1OV2P6uZZ5FSM9Ttw/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "feed",
        "kind": "videos",
        "query": {
            "channel": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
            "title": "Google for Developers"
        },
        "total": 1,
        "items": [
            {
                "platform": "youtube",
                "type": "video",
                "id": "dQw4w9WgXcQ",
                "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                "title": "Video title",
                "text": null,
                "author": {
                    "name": "Google for Developers",
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": "2026-09-28T16:00:00Z",
                "stats": {
                    "views": 120000,
                    "likes": 3200,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": []
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/channels/{channel}/videos",
        "input": {
            "channel": "UC_x5XG1OV2P6uZZ5FSM9Ttw"
        }
    }
}
GET /api/v1/social/youtube/search
0.5 credits / request 30 RPM Studio Test ↗

YouTube video search (no API key)

Search results from YouTube: video id, title, channel, views, thumbnail and duration.

Request Parameters

Parameter In Type Required Description Example
q query string Required Search keywords. laravel tutorial
curl -X GET 'https://axioapi.com/api/v1/social/youtube/search?q=laravel+tutorial' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "feed",
        "kind": "search",
        "query": {
            "q": "laravel tutorial"
        },
        "total": 1,
        "items": [
            {
                "platform": "youtube",
                "type": "video",
                "id": "dQw4w9WgXcQ",
                "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                "title": "Laravel in 100 seconds",
                "text": null,
                "author": {
                    "name": "Fireship",
                    "url": "https://www.youtube.com/channel/UCsBjURrPoezykLs9EqgamOA"
                },
                "thumbnail_url": "https://i.ytimg.com/vi/x/hq.jpg",
                "published_at": null,
                "stats": {
                    "views": 1200000,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "duration": "2:21",
                    "published_text": "2 years ago"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/search",
        "input": {
            "q": "laravel tutorial"
        }
    }
}
GET /api/v1/social/youtube/videos/{id}/download
1 credits / request 20 RPM Studio Test ↗

YouTube stream & audio download links

Direct googlevideo links with quality, mime type and size. Links expire after a few hours, so fetch them right before use.

Request Parameters

Parameter In Type Required Description Example
id path string Required YouTube video id (11 characters). dQw4w9WgXcQ
curl -X GET 'https://axioapi.com/api/v1/social/youtube/videos/dQw4w9WgXcQ/download' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "video",
        "id": "dQw4w9WgXcQ",
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "title": "Sample",
        "text": null,
        "author": {
            "name": "Channel",
            "url": "https://www.youtube.com/channel/UCx"
        },
        "thumbnail_url": "https://i.ytimg.com/vi/x/hq.jpg",
        "published_at": null,
        "stats": {
            "views": 1000,
            "likes": null,
            "dislikes": null,
            "replies": null,
            "shares": null,
            "rating": null
        },
        "extra": {
            "duration_seconds": 212,
            "formats": [
                {
                    "itag": 18,
                    "kind": "video",
                    "muxed": true,
                    "mime_type": "video/mp4; codecs=\"avc1\"",
                    "quality": "360p",
                    "width": 640,
                    "height": 360,
                    "bitrate": 500000,
                    "size_bytes": 9000000,
                    "url": "https://rr1---sn-x.googlevideo.com/videoplayback?…"
                }
            ]
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/videos/{id}/download",
        "input": {
            "id": "dQw4w9WgXcQ"
        }
    }
}
GET /api/v1/social/youtube/videos/{id}/comments
1 credits / request 20 RPM Studio Test ↗

YouTube video comments

Top comments of a YouTube video, without an API key.

Request Parameters

Parameter In Type Required Description Example
id path string Required YouTube video id. dQw4w9WgXcQ
limit query integer Optional Maximum items (1-50). 20
curl -X GET 'https://axioapi.com/api/v1/social/youtube/videos/dQw4w9WgXcQ/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "feed",
        "kind": "comments",
        "query": {
            "video": "dQw4w9WgXcQ"
        },
        "total": 1,
        "items": [
            {
                "platform": "youtube",
                "type": "comment",
                "id": "Ugx1",
                "url": null,
                "title": null,
                "text": "can confirm: he never gave us up",
                "author": {
                    "name": "@YouTube",
                    "url": "https://www.youtube.com/channel/UCx"
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": 322000,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "published_text": "1 year ago"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/videos/{id}/comments",
        "input": {
            "id": "dQw4w9WgXcQ"
        }
    }
}
GET /api/v1/social/youtube/channels/{handle}/about
0.5 credits / request 30 RPM Studio Test ↗

YouTube channel subscribers & about

Subscribers, video count, bio and avatar of a YouTube channel.

Request Parameters

Parameter In Type Required Description Example
handle path string Required Channel handle without @. lexfridman
curl -X GET 'https://axioapi.com/api/v1/social/youtube/channels/lexfridman/about' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "profile",
        "id": null,
        "username": "lexfridman",
        "display_name": "Lex Fridman",
        "headline": null,
        "description": "Conversations about science",
        "url": "https://www.youtube.com/@lexfridman",
        "avatar_url": "https://yt3.googleusercontent.com/a.jpg",
        "banner_url": null,
        "location": null,
        "followers": 1640000,
        "following": null,
        "posts_count": 450,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": []
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/channels/{handle}/about",
        "input": {
            "handle": "lexfridman"
        }
    }
}
GET /api/v1/social/youtube/playlists/{id}
0.3 credits / request 30 RPM Studio Test ↗

YouTube playlist latest videos

Latest videos of a YouTube playlist (RSS).

Request Parameters

Parameter In Type Required Description Example
id path string Required Playlist id. PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf
curl -X GET 'https://axioapi.com/api/v1/social/youtube/playlists/PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "youtube",
        "type": "feed",
        "kind": "playlist",
        "query": {
            "playlist": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
            "title": "Playlist"
        },
        "total": 1,
        "items": [
            {
                "platform": "youtube",
                "type": "video",
                "id": "dQw4w9WgXcQ",
                "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                "title": "Video",
                "text": null,
                "author": {
                    "name": null,
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": []
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/youtube/playlists/{id}",
        "input": {
            "id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"
        }
    }
}

X (Twitter) Scraper

X (Twitter) GraphQL user profile and tweet details with oEmbed & media.

GET /api/v1/social/twitter/profile
1 credits / request 20 RPM Studio Test ↗

X (Twitter) GraphQL profile

Retrieves verified profile data, follower count, description, and avatar for any public X handle.

Request Parameters

Parameter In Type Required Description Example
username query string Required Twitter screen name (without @). taylorotwell
fresh query boolean Optional Force fresh scrape bypassing cache. (Default: false)
curl -X GET 'https://axioapi.com/api/v1/social/twitter/profile?username=taylorotwell' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "screen_name": "taylorotwell",
        "name": "Taylor Otwell",
        "description": "Creator of Laravel.",
        "followers_count": 320000,
        "verified": true,
        "profile_image_url": "https://pbs.twimg.com/profile_images/..."
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/twitter/profile",
        "input": {
            "username": "taylorotwell"
        }
    }
}
GET /api/v1/social/twitter/tweets/{id}
0.5 credits / request 30 RPM Studio Test ↗

X (Twitter) tweet oEmbed

Returns author name, tweet body text, and official oEmbed widget HTML for rendering.

Request Parameters

Parameter In Type Required Description Example
id path string Required Numeric tweet ID. 20
url query string Optional -
curl -X GET 'https://axioapi.com/api/v1/social/twitter/tweets/20' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "id": "20",
        "author_name": "Jack Dorsey",
        "html": "<blockquote class=\"twitter-tweet\">just setting up my twttr</blockquote>",
        "url": "https://twitter.com/jack/status/20"
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/twitter/tweets/{id}",
        "input": {
            "id": "20"
        }
    }
}
GET /api/v1/social/twitter/users/{username}/timeline
1 credits / request 10 RPM Studio Test ↗

X (Twitter) user timeline

Latest public tweets of a user from the X syndication timeline, with counts and media.

Request Parameters

Parameter In Type Required Description Example
username path string Required X handle without @. nasa
limit query integer Optional Maximum tweets (1-50). (Default: 10) 20
curl -X GET 'https://axioapi.com/api/v1/social/twitter/users/nasa/timeline' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "twitter",
        "type": "feed",
        "kind": "timeline",
        "query": {
            "username": "nasa"
        },
        "total": 1,
        "items": [
            {
                "platform": "twitter",
                "type": "post",
                "id": "1850000000000000000",
                "url": "https://x.com/nasa/status/1850000000000000000",
                "title": null,
                "text": "Liftoff!",
                "author": {
                    "name": "NASA",
                    "url": "https://x.com/nasa"
                },
                "thumbnail_url": "https://pbs.twimg.com/profile_images/a.jpg",
                "published_at": "2026-09-30T12:00:00Z",
                "stats": {
                    "views": null,
                    "likes": 5000,
                    "dislikes": null,
                    "replies": 120,
                    "shares": 900,
                    "rating": null
                },
                "extra": {
                    "media": []
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/twitter/users/{username}/timeline",
        "input": {
            "username": "nasa"
        }
    }
}
GET /api/v1/social/twitter/trends
0.3 credits / request 30 RPM Studio Test ↗

X (Twitter) trending topics

Trending topics on X (Twitter) for a country.

Request Parameters

Parameter In Type Required Description Example
country query string Optional Country slug such as vietnam or united-states; empty = worldwide. vietnam
limit query integer Optional Maximum items (1-50). 20
curl -X GET 'https://axioapi.com/api/v1/social/twitter/trends' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "twitter",
        "type": "feed",
        "kind": "trends",
        "query": {
            "country": "vietnam"
        },
        "total": 1,
        "items": [
            {
                "platform": "twitter",
                "type": "trend",
                "id": "#Topic",
                "url": "https://x.com/search?q=%23Topic",
                "title": "#Topic",
                "text": null,
                "author": {
                    "name": null,
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "rank": 1
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/twitter/trends",
        "input": []
    }
}

LinkedIn Scraper

Public LinkedIn company/member profiles and guest job search.

GET /api/v1/social/linkedin/profile
2 credits / request 15 RPM Studio Test ↗

LinkedIn profile intelligence

Fetches structured profile data for any public LinkedIn member using their vanity username.

Request Parameters

Parameter In Type Required Description Example
vanity query string Required LinkedIn username / vanity slug from URL (e.g. linkedin.com/in/{vanity}). satyanadella
fresh query boolean Optional Bypass 24-hour cache when true. (Default: false)
curl -X GET 'https://axioapi.com/api/v1/social/linkedin/profile?vanity=satyanadella' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "name": "Satya Nadella",
        "headline": "Chairman and CEO at Microsoft",
        "location": "Greater Seattle Area",
        "connections": 500,
        "followers": 11000000,
        "summary": "Chairman and Chief Executive Officer of Microsoft..."
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/linkedin/profile",
        "input": {
            "vanity": "satyanadella"
        }
    }
}
GET /api/v1/social/linkedin/jobs
1.5 credits / request 20 RPM Studio Test ↗

LinkedIn guest job search

Returns active LinkedIn job postings with title, company, location, date posted, and direct apply link.

Request Parameters

Parameter In Type Required Description Example
keywords query string Required Job title, skill, or company keyword. software engineer
location query string Optional City, state, or country name. (Default: Vietnam) Vietnam
start query integer Optional Offset for pagination. (Default: 0) 0
count query integer Optional Number of jobs to retrieve (max 25). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/linkedin/jobs?keywords=software+engineer' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": [
        {
            "id": "4102941",
            "title": "Senior Backend Engineer (PHP/Go)",
            "company": "Tech Corp",
            "location": "Ho Chi Minh City, Vietnam",
            "posted_at": "2 days ago",
            "url": "https://www.linkedin.com/jobs/view/4102941"
        }
    ],
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/linkedin/jobs",
        "input": {
            "keywords": "software engineer"
        }
    }
}
GET /api/v1/social/linkedin/companies/{company}
2 credits / request 15 RPM Studio Test ↗

LinkedIn company page

Public LinkedIn company page: followers, size and recent posts.

Request Parameters

Parameter In Type Required Description Example
company path string Required Company slug from the LinkedIn URL. google
curl -X GET 'https://axioapi.com/api/v1/social/linkedin/companies/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "linkedin",
        "type": "profile",
        "id": null,
        "username": "google",
        "display_name": "Google",
        "headline": null,
        "description": "A problem isn't truly solved until it's solved for all.",
        "url": "https://www.linkedin.com/company/google",
        "avatar_url": null,
        "banner_url": null,
        "location": null,
        "followers": 42400000,
        "following": null,
        "posts_count": null,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": {
            "employees": 10001,
            "industry": "Software",
            "location": "Mountain View",
            "recent_posts": []
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/linkedin/companies/{company}",
        "input": {
            "company": "google"
        }
    }
}
GET /api/v1/social/linkedin/jobs/{id}
1 credits / request 20 RPM Studio Test ↗

LinkedIn job detail

Full description and criteria of a public LinkedIn job.

Request Parameters

Parameter In Type Required Description Example
id path string Required Numeric job id. 3800000000
curl -X GET 'https://axioapi.com/api/v1/social/linkedin/jobs/3800000000' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "linkedin",
        "type": "job",
        "id": "3800000000",
        "url": "https://www.linkedin.com/jobs/view/3800000000",
        "title": "Backend Engineer",
        "text": "Build APIs.",
        "author": {
            "name": "Acme",
            "url": "https://www.linkedin.com/company/acme"
        },
        "thumbnail_url": null,
        "published_at": null,
        "stats": {
            "views": null,
            "likes": null,
            "dislikes": null,
            "replies": null,
            "shares": null,
            "rating": null
        },
        "extra": {
            "location": "Ho Chi Minh City",
            "criteria": [
                "Mid-Senior level",
                "Full-time"
            ]
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/linkedin/jobs/{id}",
        "input": {
            "id": "3800000000"
        }
    }
}

Reddit Scraper

Reddit subreddit hot/new posts and recursive comments tree.

GET /api/v1/social/reddit/subreddits/{subreddit}/posts
1 credits / request 20 RPM Studio Test ↗

Reddit subreddit posts

Posts of a subreddit (hot, new, top or rising).

Request Parameters

Parameter In Type Required Description Example
subreddit path string Required Subreddit name without r/. programming
sort query string Optional hot, new, top or rising. (Default: hot) hot
limit query integer Optional Items to return (1-50). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/reddit/subreddits/programming/posts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "reddit",
        "type": "feed",
        "kind": "posts",
        "query": {
            "subreddit": "programming",
            "sort": "hot"
        },
        "total": 1,
        "items": [
            {
                "platform": "reddit",
                "type": "post",
                "id": "1abcde",
                "url": "https://www.reddit.com/r/programming/comments/1abcde/title/",
                "title": "Post title",
                "text": null,
                "author": {
                    "name": "someone",
                    "url": "https://www.reddit.com/user/someone"
                },
                "thumbnail_url": null,
                "published_at": "2026-09-30T07:00:00Z",
                "stats": {
                    "views": null,
                    "likes": 1200,
                    "dislikes": null,
                    "replies": 300,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "subreddit": "programming",
                    "nsfw": false
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/reddit/subreddits/{subreddit}/posts",
        "input": {
            "subreddit": "programming"
        }
    }
}
GET /api/v1/social/reddit/posts/{id}/comments
1 credits / request 20 RPM Studio Test ↗

Reddit post comments

Comments of a Reddit post as a flat list with a depth.

Request Parameters

Parameter In Type Required Description Example
id path string Required Post ID (the part after /comments/ in the URL). 1abcde
limit query integer Optional Items to return (1-50). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/reddit/posts/1abcde/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "reddit",
        "type": "feed",
        "kind": "comments",
        "query": {
            "post": "1abcde",
            "title": "Post title"
        },
        "total": 1,
        "items": [
            {
                "platform": "reddit",
                "type": "comment",
                "id": "k1",
                "url": "https://www.reddit.com/r/programming/comments/1abcde/title/k1/",
                "title": null,
                "text": "Great post",
                "author": {
                    "name": "someone",
                    "url": "https://www.reddit.com/user/someone"
                },
                "thumbnail_url": null,
                "published_at": "2026-09-30T07:30:00Z",
                "stats": {
                    "views": null,
                    "likes": 45,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "depth": 0,
                    "parent_id": "t3_1abcde"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/reddit/posts/{id}/comments",
        "input": {
            "id": "1abcde"
        }
    }
}

GitHub Scraper

GitHub user profile, public repositories search, and developer activity feed.

GET /api/v1/social/github/users/{username}
0.5 credits / request 30 RPM Studio Test ↗

GitHub user profile

Public GitHub profile of a user.

Request Parameters

Parameter In Type Required Description Example
username path string Required GitHub username. torvalds
curl -X GET 'https://axioapi.com/api/v1/social/github/users/torvalds' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "github",
        "type": "profile",
        "id": "1024025",
        "username": "torvalds",
        "display_name": "Linus Torvalds",
        "headline": null,
        "description": null,
        "url": "https://github.com/torvalds",
        "avatar_url": "https://avatars.githubusercontent.com/u/1024025?v=4",
        "banner_url": null,
        "location": null,
        "followers": 250000,
        "following": 0,
        "posts_count": 7,
        "likes": null,
        "verified": null,
        "created_at": "2011-09-03T15:26:22Z",
        "extra": {
            "company": "Linux Foundation",
            "blog": null,
            "public_gists": 0,
            "twitter_username": null,
            "type": "User"
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/github/users/{username}",
        "input": {
            "username": "torvalds"
        }
    }
}
GET /api/v1/social/github/repos
0.5 credits / request 20 RPM Studio Test ↗

GitHub repository search

Search public GitHub repositories.

Request Parameters

Parameter In Type Required Description Example
q query string Required Search query. laravel
sort query string Optional Sort by stars, forks or updated. (Default: stars) stars
limit query integer Optional Items to return (1-50). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/github/repos?q=laravel' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "github",
        "type": "feed",
        "kind": "repos",
        "query": {
            "q": "laravel",
            "sort": "stars"
        },
        "total": 1,
        "items": [
            {
                "platform": "github",
                "type": "repo",
                "id": "laravel/laravel",
                "url": "https://github.com/laravel/laravel",
                "title": "laravel/laravel",
                "text": "Laravel is a web application framework.",
                "author": {
                    "name": "laravel",
                    "url": "https://github.com/laravel"
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": 80000,
                    "dislikes": null,
                    "replies": null,
                    "shares": 24000,
                    "rating": null
                },
                "extra": {
                    "language": "PHP"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/github/repos",
        "input": {
            "q": "laravel"
        }
    }
}
GET /api/v1/social/github/users/{username}/activity
0.5 credits / request 20 RPM Studio Test ↗

GitHub public activity feed

Recent public activity of a GitHub user (Atom feed, no rate limit).

Request Parameters

Parameter In Type Required Description Example
username path string Required GitHub username. torvalds
curl -X GET 'https://axioapi.com/api/v1/social/github/users/torvalds/activity' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "github",
        "type": "feed",
        "kind": "events",
        "query": {
            "username": "torvalds"
        },
        "total": 1,
        "items": [
            {
                "platform": "github",
                "type": "event",
                "id": "tag:github.com,2008:PushEvent/1",
                "url": "https://github.com/torvalds/linux/compare/a...b",
                "title": "torvalds pushed to master in torvalds/linux",
                "text": null,
                "author": {
                    "name": "torvalds",
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": "2026-09-30T02:27:57Z",
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "kind": "PushEvent"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/github/users/{username}/activity",
        "input": {
            "username": "torvalds"
        }
    }
}
GET /api/v1/social/github/repos/{owner}/{repo}
0.5 credits / request 30 RPM Studio Test ↗

GitHub repository detail

Stars, forks, language and topics of one GitHub repository.

Request Parameters

Parameter In Type Required Description Example
owner path string Required Repository owner. laravel
repo path string Required Repository name. framework
curl -X GET 'https://axioapi.com/api/v1/social/github/repos/laravel/framework' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "github",
        "type": "repo",
        "id": "laravel/framework",
        "url": "https://github.com/laravel/framework",
        "title": "laravel/framework",
        "text": null,
        "author": {
            "name": null,
            "url": null
        },
        "thumbnail_url": null,
        "published_at": null,
        "stats": {
            "views": null,
            "likes": 30000,
            "dislikes": null,
            "replies": null,
            "shares": 11000,
            "rating": null
        },
        "extra": {
            "language": "PHP",
            "topics": [
                "laravel"
            ],
            "open_issues": 100,
            "license": "MIT"
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/github/repos/{owner}/{repo}",
        "input": {
            "owner": "laravel",
            "repo": "framework"
        }
    }
}

Community & Open Social

Telegram channels, Discord invites, Hacker News, Pinterest, Bluesky, Mastodon, Substack, Twitch.

GET /api/v1/social/telegram/channels/{channel}
0.5 credits / request 30 RPM Studio Test ↗

Telegram channel feed preview

Inspects public Telegram channel previews without needing a bot token or Telegram login.

Request Parameters

Parameter In Type Required Description Example
channel path string Required Channel username (without @ or t.me/). durov
curl -X GET 'https://axioapi.com/api/v1/social/telegram/channels/durov' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "channel": "durov",
        "title": "Pavel Durov",
        "subscribers": 2500000,
        "description": "Thoughts from the creator of Telegram.",
        "recent_posts_count": 10
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/telegram/channels/{channel}",
        "input": {
            "channel": "durov"
        }
    }
}
GET /api/v1/social/pinterest/users/{username}/pins
1 credits / request 20 RPM Studio Test ↗

Pinterest user pins

Latest pins of a Pinterest user (widget JSON).

Request Parameters

Parameter In Type Required Description Example
username path string Required Pinterest username. pinterest
curl -X GET 'https://axioapi.com/api/v1/social/pinterest/users/pinterest/pins' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "pinterest",
        "type": "feed",
        "kind": "pins",
        "query": {
            "username": "pinterest"
        },
        "total": 1,
        "items": [
            {
                "platform": "pinterest",
                "type": "pin",
                "id": "424605208526455283",
                "url": "https://www.pinterest.com/pin/424605208526455283/",
                "title": null,
                "text": "#food #dinner",
                "author": {
                    "name": "Pinterest",
                    "url": null
                },
                "thumbnail_url": "https://i.pinimg.com/originals/aa/bb/cc.jpg",
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": 345,
                    "rating": null
                },
                "extra": {
                    "dominant_color": "#5a3c34",
                    "is_video": false
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/pinterest/users/{username}/pins",
        "input": {
            "username": "pinterest"
        }
    }
}
GET /api/v1/social/pinterest/pins/{id}
0.5 credits / request 30 RPM Studio Test ↗

Pinterest pin detail

One Pinterest pin with its original-size image, video link, repin count and the pinner.

Request Parameters

Parameter In Type Required Description Example
id path string Required Numeric pin id. 99007199254
curl -X GET 'https://axioapi.com/api/v1/social/pinterest/pins/99007199254' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "pinterest",
        "type": "pin",
        "id": "99007199254",
        "url": "https://www.pinterest.com/pin/99007199254/",
        "title": "Chair",
        "text": "A chair",
        "author": {
            "name": "Maker",
            "url": "https://www.pinterest.com/maker/"
        },
        "thumbnail_url": "https://i.pinimg.com/237x/a.jpg",
        "published_at": null,
        "stats": {
            "views": null,
            "likes": null,
            "dislikes": null,
            "replies": null,
            "shares": 12,
            "rating": null
        },
        "extra": {
            "image_url": "https://i.pinimg.com/originals/a.jpg",
            "video_url": null,
            "link": "https://shop.example/chair",
            "board": null
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/pinterest/pins/{id}",
        "input": {
            "id": "99007199254"
        }
    }
}
GET /api/v1/social/bluesky/profiles/{handle}
0.5 credits / request 30 RPM Studio Test ↗

Bluesky profile

Public Bluesky profile.

Request Parameters

Parameter In Type Required Description Example
handle path string Required Handle (domain) or DID. bsky.app
curl -X GET 'https://axioapi.com/api/v1/social/bluesky/profiles/bsky.app' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "bluesky",
        "type": "profile",
        "id": "did:plc:z72i7hdynmk6r22z27h6tvur",
        "username": "bsky.app",
        "display_name": "Bluesky",
        "headline": null,
        "description": null,
        "url": "https://bsky.app/profile/bsky.app",
        "avatar_url": null,
        "banner_url": null,
        "location": null,
        "followers": 30000000,
        "following": 5,
        "posts_count": 900,
        "likes": null,
        "verified": null,
        "created_at": "2023-04-12T04:53:57.057Z",
        "extra": []
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/bluesky/profiles/{handle}",
        "input": {
            "handle": "bsky.app"
        }
    }
}
GET /api/v1/social/mastodon/accounts/{acct}
0.5 credits / request 30 RPM Studio Test ↗

Mastodon profile

Public Mastodon account profile.

Request Parameters

Parameter In Type Required Description Example
acct path string Required Account name without the instance. Gargron
instance query string Optional Instance host. (Default: mastodon.social) mastodon.social
curl -X GET 'https://axioapi.com/api/v1/social/mastodon/accounts/Gargron' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "mastodon",
        "type": "profile",
        "id": "1",
        "username": "Gargron",
        "display_name": "Eugen Rochko",
        "headline": null,
        "description": null,
        "url": "https://mastodon.social/@Gargron",
        "avatar_url": null,
        "banner_url": null,
        "location": null,
        "followers": 382899,
        "following": 743,
        "posts_count": 82349,
        "likes": null,
        "verified": null,
        "created_at": "2016-03-16T00:00:00.000Z",
        "extra": {
            "instance": "mastodon.social",
            "bot": false,
            "locked": false
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/mastodon/accounts/{acct}",
        "input": {
            "acct": "Gargron"
        }
    }
}
GET /api/v1/social/bluesky/profiles/{handle}/feed
0.5 credits / request 30 RPM Studio Test ↗

Bluesky author feed

Latest posts of a Bluesky account.

Request Parameters

Parameter In Type Required Description Example
handle path string Required Bluesky handle or DID. bsky.app
limit query integer Optional Maximum items (1-50). 20
curl -X GET 'https://axioapi.com/api/v1/social/bluesky/profiles/bsky.app/feed' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "bluesky",
        "type": "feed",
        "kind": "feed",
        "query": {
            "handle": "bsky.app"
        },
        "total": 1,
        "items": [
            {
                "platform": "bluesky",
                "type": "post",
                "id": "at://did:plc:x/app.bsky.feed.post/3k",
                "url": null,
                "title": null,
                "text": "Hello",
                "author": {
                    "name": null,
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": 10,
                    "dislikes": null,
                    "replies": 1,
                    "shares": 2,
                    "rating": null
                },
                "extra": {
                    "images": [],
                    "is_repost": false
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/bluesky/profiles/{handle}/feed",
        "input": {
            "handle": "bsky.app"
        }
    }
}
GET /api/v1/social/substack/{publication}/posts
0.5 credits / request 30 RPM Studio Test ↗

Substack newsletter posts

Latest posts of a Substack newsletter (RSS).

Request Parameters

Parameter In Type Required Description Example
publication path string Required Publication subdomain (name.substack.com). stratechery
limit query integer Optional Items to return (1-50). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/substack/stratechery/posts' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "substack",
        "type": "feed",
        "kind": "posts",
        "query": {
            "publication": "stratechery",
            "title": "Stratechery"
        },
        "total": 1,
        "items": [
            {
                "platform": "substack",
                "type": "post",
                "id": "https://stratechery.substack.com/p/example",
                "url": "https://stratechery.substack.com/p/example",
                "title": "Post title",
                "text": "Summary…",
                "author": {
                    "name": "Ben Thompson",
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": "2026-09-29T12:00:00Z",
                "stats": {
                    "views": null,
                    "likes": null,
                    "dislikes": null,
                    "replies": null,
                    "shares": null,
                    "rating": null
                },
                "extra": []
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/substack/{publication}/posts",
        "input": {
            "publication": "stratechery"
        }
    }
}
GET /api/v1/social/spotify/tracks/{id}
0.3 credits / request 30 RPM Studio Test ↗

Spotify track oEmbed

Title and cover of a Spotify track (oEmbed).

Request Parameters

Parameter In Type Required Description Example
id path string Required Spotify track id. 4cOdK2wGLETKBW3PvgPWqT
curl -X GET 'https://axioapi.com/api/v1/social/spotify/tracks/4cOdK2wGLETKBW3PvgPWqT' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "spotify",
        "type": "track",
        "id": "4cOdK2wGLETKBW3PvgPWqT",
        "url": "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT",
        "title": "Never Gonna Give You Up",
        "text": null,
        "author": {
            "name": null,
            "url": null
        },
        "thumbnail_url": null,
        "published_at": null,
        "stats": {
            "views": null,
            "likes": null,
            "dislikes": null,
            "replies": null,
            "shares": null,
            "rating": null
        },
        "extra": {
            "embed_html": "<iframe></iframe>",
            "provider_name": "Spotify"
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/spotify/tracks/{id}",
        "input": {
            "id": "4cOdK2wGLETKBW3PvgPWqT"
        }
    }
}
GET /api/v1/social/discord/invites/{code}
0.5 credits / request 30 RPM Studio Test ↗

Discord server invite info

Public info of a Discord server from an invite code.

Request Parameters

Parameter In Type Required Description Example
code path string Required Invite code (discord.gg/code). python
curl -X GET 'https://axioapi.com/api/v1/social/discord/invites/python' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "discord",
        "type": "profile",
        "id": "267624335836053506",
        "username": "python",
        "display_name": "Python",
        "headline": null,
        "description": "We are a large community focused around the Python programming language.",
        "url": "https://discord.gg/python",
        "avatar_url": null,
        "banner_url": null,
        "location": null,
        "followers": 400000,
        "following": null,
        "posts_count": null,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": {
            "online": 25000,
            "features": [
                "COMMUNITY"
            ],
            "verification_level": 3
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/discord/invites/{code}",
        "input": {
            "code": "python"
        }
    }
}
GET /api/v1/social/devto/articles
0.3 credits / request 30 RPM Studio Test ↗

Dev.to articles

Latest or tagged Dev.to articles.

Request Parameters

Parameter In Type Required Description Example
tag query string Optional Tag to filter by. laravel
limit query integer Optional Maximum items (1-50). 20
curl -X GET 'https://axioapi.com/api/v1/social/devto/articles' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "devto",
        "type": "feed",
        "kind": "articles",
        "query": {
            "tag": "laravel"
        },
        "total": 1,
        "items": [
            {
                "platform": "devto",
                "type": "article",
                "id": "1",
                "url": null,
                "title": "Article",
                "text": null,
                "author": {
                    "name": null,
                    "url": null
                },
                "thumbnail_url": null,
                "published_at": null,
                "stats": {
                    "views": null,
                    "likes": 50,
                    "dislikes": null,
                    "replies": 4,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "tags": [
                        "laravel"
                    ],
                    "reading_time_minutes": 5
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/devto/articles",
        "input": []
    }
}
GET /api/v1/social/hackernews/stories
0.3 credits / request 60 RPM Studio Test ↗

Hacker News stories

Hacker News stories (front page, new, ask or show).

Request Parameters

Parameter In Type Required Description Example
type query string Optional front_page, new, ask or show. (Default: front_page) front_page
limit query integer Optional Items to return (1-50). (Default: 10) 10
curl -X GET 'https://axioapi.com/api/v1/social/hackernews/stories' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "hackernews",
        "type": "feed",
        "kind": "stories",
        "query": {
            "type": "front_page"
        },
        "total": 1,
        "items": [
            {
                "platform": "hackernews",
                "type": "story",
                "id": "49914236",
                "url": "https://example.com/story",
                "title": "Story title",
                "text": null,
                "author": {
                    "name": "someone",
                    "url": "https://news.ycombinator.com/user?id=someone"
                },
                "thumbnail_url": null,
                "published_at": "2026-09-30T08:00:00Z",
                "stats": {
                    "views": null,
                    "likes": 320,
                    "dislikes": null,
                    "replies": 150,
                    "shares": null,
                    "rating": null
                },
                "extra": {
                    "discussion_url": "https://news.ycombinator.com/item?id=49914236"
                }
            }
        ]
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/hackernews/stories",
        "input": []
    }
}
GET /api/v1/social/twitch/channels/{channel}
0.5 credits / request 30 RPM Studio Test ↗

Twitch channel status

Live status of a Twitch channel.

Request Parameters

Parameter In Type Required Description Example
channel path string Required Twitch channel name. ninja
curl -X GET 'https://axioapi.com/api/v1/social/twitch/channels/ninja' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "twitch",
        "type": "profile",
        "id": null,
        "username": "ninja",
        "display_name": "ninja",
        "headline": null,
        "description": null,
        "url": "https://www.twitch.tv/ninja",
        "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/ninja.png",
        "banner_url": null,
        "location": null,
        "followers": null,
        "following": null,
        "posts_count": null,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": {
            "live": false,
            "uptime": null
        }
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/twitch/channels/{channel}",
        "input": {
            "channel": "ninja"
        }
    }
}
GET /api/v1/social/threads/profiles/{username}
1 credits / request 20 RPM Studio Test ↗

Threads public profile

Public Threads profile read without a login.

Request Parameters

Parameter In Type Required Description Example
username path string Required Threads username. zuck
curl -X GET 'https://axioapi.com/api/v1/social/threads/profiles/zuck' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'
200 OK Response Sample (200 OK)
{
    "status": "success",
    "data": {
        "platform": "threads",
        "type": "profile",
        "id": null,
        "username": "zuck",
        "display_name": "Mark Zuckerberg",
        "headline": null,
        "description": "Mostly superintelligence and MMA takes",
        "url": "https://www.threads.net/@zuck",
        "avatar_url": "https://scontent.cdninstagram.com/z.jpg",
        "banner_url": null,
        "location": null,
        "followers": 5300000,
        "following": null,
        "posts_count": null,
        "likes": null,
        "verified": null,
        "created_at": null,
        "extra": []
    },
    "request": {
        "id": "7f1c2c1e-9a3b-4c55-8d0e-2b6f4c9a1d10",
        "method": "GET",
        "path": "/api/v1/social/threads/profiles/{username}",
        "input": {
            "username": "zuck"
        }
    }
}

Standard Error Codes

Mọi phản hồi lỗi đều tuân thủ cấu trúc chuẩn với mã lỗi máy đọc được và request_id duy nhất.

400 bad_request · Bad Request
Content-Type: application/json

The request payload is malformed or missing required headers.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "bad_request",
        "message": "Malformed JSON in request body.",
        "request_id": "req_01j7abcde1234567890"
    },
    "request": {
        "id": "req_01j7abcde1234567890",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
401 unauthorized · Unauthorized / Invalid Token
Content-Type: application/json

Missing or invalid Bearer token in Authorization header.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "unauthorized",
        "message": "Unauthenticated or invalid API key provided.",
        "request_id": "req_01j7abcde1234567891"
    },
    "request": {
        "id": "req_01j7abcde1234567891",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
402 insufficient_credits · Payment Required / Low Balance
Content-Type: application/json

Your credit balance is lower than the cost of this capability. Top up credits in billing.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "insufficient_credits",
        "message": "Your wallet balance (0.20 credits) is insufficient for this call (1.00 credit).",
        "request_id": "req_01j7abcde1234567892"
    },
    "request": {
        "id": "req_01j7abcde1234567892",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
404 resource_not_found · Resource Not Found
Content-Type: application/json

The requested inbox, session, job, or video was not found or expired.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "resource_not_found",
        "message": "Requested inbox or session has expired or does not exist.",
        "request_id": "req_01j7abcde1234567893"
    },
    "request": {
        "id": "req_01j7abcde1234567893",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
422 validation_failed · Unprocessable Content / Validation Error
Content-Type: application/json

One or more request parameters failed validation rules (e.g. invalid format, out of range).

{
    "status": "failed",
    "data": null,
    "message": "The emails.0 field must be a valid email address.",
    "errors": {
        "emails.0": [
            "The emails.0 field must be a valid email address."
        ]
    },
    "request": {
        "id": null,
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
429 rate_limit_exceeded · Rate Limit Exceeded
Content-Type: application/json

Exceeded your plan requests-per-minute (RPM) or requests-per-day (RPD) limit.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "rate_limit_exceeded",
        "message": "Too many requests. Limit is 30 RPM. Retry in 14 seconds.",
        "retry_after": 14,
        "request_id": "req_01j7abcde1234567894"
    },
    "request": {
        "id": "req_01j7abcde1234567894",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}
503 service_unavailable · Service Unavailable
Content-Type: application/json

The API service is temporarily unavailable. Please try again later.

{
    "status": "failed",
    "data": null,
    "error": {
        "code": "service_unavailable",
        "message": "The API service is temporarily unavailable. Please try again later.",
        "request_id": "req_01j7abcde1234567895"
    },
    "request": {
        "id": "req_01j7abcde1234567895",
        "method": "GET",
        "path": "/api/v1/...",
        "input": []
    }
}