API Documentation

Build powerful integrations with Nameely's RESTful API. Manage social media posts, analytics, and accounts programmatically.

Get API Access Quick Start Guide

RESTful API

Clean, predictable URLs and standard HTTP methods with JSON responses.

Secure Authentication

OAuth 2.0 and API key authentication with rate limiting and encryption.

Real-time Webhooks

Get instant notifications when posts are published or analytics update.

Quick Start Guide

Get started with the Nameely API in just a few minutes. Follow these steps to make your first API call.

Get Your API Key

Generate an API key from your dashboard settings

Go to Settings → API Keys

Make Your First Request

Test the API with a simple GET request to fetch your posts

Use the example code above

Handle Authentication

Include your API key in the Authorization header

Bearer YOUR_API_TOKEN

Create Your First Post

Use the POST /posts endpoint to create content

See the create post example

Code Examples

curl -X GET "https://api.nameely.com/v1/posts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

API Endpoints

Complete reference for all available API endpoints with parameters and examples.

GET/api/v1/posts

Retrieve all posts for the authenticated user

Parameters:

limit

integer

Number of posts to return (default: 50, max: 100)

offset

integer

Number of posts to skip for pagination

status

string

Filter by post status: draft, scheduled, published, failed

platform

string

Filter by platform: twitter, facebook, instagram, linkedin

POST/api/v1/posts

Create a new post

Parameters:

contentrequired

string

The post content text

platformsrequired

array

Array of platform IDs to post to

scheduled_at

datetime

ISO 8601 datetime for scheduling (optional)

media_ids

array

Array of uploaded media file IDs

GET/api/v1/analytics

Get analytics data for posts and accounts

Parameters:

start_date

date

Start date for analytics period (YYYY-MM-DD)

end_date

date

End date for analytics period (YYYY-MM-DD)

platform

string

Filter by specific platform

metrics

array

Specific metrics to include: impressions, engagement, clicks

GET/api/v1/accounts

List all connected social media accounts

Parameters:

platform

string

Filter by platform type

status

string

Filter by connection status: active, expired, error

Official SDKs

Use our official SDKs to integrate Nameely into your applications with ease.

🟢

Node.js

@nameely/sdk

Available

npm install @nameely/sdk

View Documentation

🐍

Python

nameely-python

Available

pip install nameely-python

View Documentation

🐘

PHP

nameely/php-sdk

Available

composer require nameely/php-sdk

View Documentation

💎

Ruby

nameely-ruby

Coming Soon

gem install nameely-ruby

🐹

Go

nameely-go

Coming Soon

go get github.com/nameely/go-sdk

Authentication

Secure your API requests with our authentication methods.

Ready to Build with Our API?

Start building powerful integrations today. Get API access with any paid plan and join our developer community.

Get API Access Contact Developer Support

API Documentation

Build powerful integrations with Nameely's RESTful API. Manage social media posts, analytics, and accounts programmatically.

Get API Access Quick Start Guide

RESTful API

Clean, predictable URLs and standard HTTP methods with JSON responses.

Secure Authentication

OAuth 2.0 and API key authentication with rate limiting and encryption.

Real-time Webhooks

Get instant notifications when posts are published or analytics update.

Quick Start Guide

Get started with the Nameely API in just a few minutes. Follow these steps to make your first API call.

Get Your API Key

Generate an API key from your dashboard settings

Go to Settings → API Keys

Make Your First Request

Test the API with a simple GET request to fetch your posts

Use the example code above

Handle Authentication

Include your API key in the Authorization header

Bearer YOUR_API_TOKEN

Create Your First Post

Use the POST /posts endpoint to create content

See the create post example

Code Examples

curl -X GET "https://api.nameely.com/v1/posts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

API Endpoints

Complete reference for all available API endpoints with parameters and examples.

GET/api/v1/posts

Retrieve all posts for the authenticated user

Parameters:

limit

integer

Number of posts to return (default: 50, max: 100)

offset

integer

Number of posts to skip for pagination

status

string

Filter by post status: draft, scheduled, published, failed

platform

string

Filter by platform: twitter, facebook, instagram, linkedin

POST/api/v1/posts

Create a new post

Parameters:

contentrequired

string

The post content text

platformsrequired

array

Array of platform IDs to post to

scheduled_at

datetime

ISO 8601 datetime for scheduling (optional)

media_ids

array

Array of uploaded media file IDs

GET/api/v1/analytics

Get analytics data for posts and accounts

Parameters:

start_date

date

Start date for analytics period (YYYY-MM-DD)

end_date

date

End date for analytics period (YYYY-MM-DD)

platform

string

Filter by specific platform

metrics

array

Specific metrics to include: impressions, engagement, clicks

GET/api/v1/accounts

List all connected social media accounts

Parameters:

platform

string

Filter by platform type

status

string

Filter by connection status: active, expired, error

Official SDKs

Use our official SDKs to integrate Nameely into your applications with ease.

🟢

Node.js

@nameely/sdk

Available

npm install @nameely/sdk

View Documentation

🐍

Python

nameely-python

Available

pip install nameely-python

View Documentation

🐘

PHP

nameely/php-sdk

Available

composer require nameely/php-sdk

View Documentation

💎

Ruby

nameely-ruby

Coming Soon

gem install nameely-ruby

🐹

Go

nameely-go

Coming Soon

go get github.com/nameely/go-sdk

Authentication

Secure your API requests with our authentication methods.

Ready to Build with Our API?

Start building powerful integrations today. Get API access with any paid plan and join our developer community.

Get API Access Contact Developer Support

API Documentation

RESTful API

Secure Authentication

Real-time Webhooks

Quick Start Guide

Get Your API Key

Make Your First Request

Handle Authentication

Create Your First Post

Code Examples

API Endpoints

Parameters:

Parameters:

Parameters:

Parameters:

Official SDKs

Node.js

Python

PHP

Ruby

Go

Authentication

API Key Authentication

OAuth 2.0 Flow

Rate Limiting

Error Handling

Ready to Build with Our API?

API Documentation

RESTful API

Secure Authentication

Real-time Webhooks

Quick Start Guide

Get Your API Key

Make Your First Request

Handle Authentication

Create Your First Post

Code Examples

API Endpoints

Parameters:

Parameters:

Parameters:

Parameters:

Official SDKs

Node.js

Python

PHP

Ruby

Go

Authentication

API Key Authentication

OAuth 2.0 Flow

Rate Limiting

Error Handling

Ready to Build with Our API?