Metapic API docs

Introduction

Base URL: https://api.metapic.dev

This documentation aims to provide all the information you need to work with our API. The v2 (and above) API follows the Design Principles and Guidelines. If you find anything that doesn't comply, please complain to the dev team immediately 👮

Authenticating requests

To authenticate requests, include a Authorization header with the value "{accessToken}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

For more information see Authentication in the P&E docs.

Client

List clients

GET

https://api.metapic.dev

/v2/clients

requires authentication

Endpoint for querying & sorting all clients.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

name

string

Query by client's name or User revenue tier name. Returns all clients matching the given name. Must not be greater than 255 characters.

Example:

Metapic SE

store_group_id

integer

Query by client's store group. Returns all clients which belong to the given store_group_id.

Example:

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

sort_by

string

Must follow the correct format: column_name:direction, where column_name must be a valid property for given resource and direction can be one of asc|desc, both of which are required if sort_by is present.

Example:

created_at:desc

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/clients?name=Metapic+SE&store_group_id=15&size=20&sort_by=created_at%3Adesc" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "name": "Anita Russel DVM"
        },
        {
            "id": null,
            "name": "Kathlyn Shields Sr."
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Creator Media

Operations on Media posted by Creators

Lists Creator generated media captured by Metapic.

GET

https://api.metapic.dev

/v2/user-media

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

query

string

Filters media by username.

Example:

voluptatem

status

string

Filter user media by show store value.

Must be one of:

all
0
1
2

Example:

type

string

Filters media by type.

Must be one of:

all
instagram
tiktok
youtube

Example:

instagram

favorite

string

Filter user media by favorite value.

Must be one of:

all
1
0

Example:

group

integer

:shrug:.

Example:

format

string

Format to export.

Must be one of:

csv
xlsx
json

Example:

csv

Response Fields

media_type

string

Describes the source of the media

Must be one of:

instagram
tiktok
youtube

media_id

string

Unique identifier of the video in YouTube.

Only present when media_type = 'youtube'.

Should be used for generating the URL for embedding the YouTube player, as described in https://developers.google.com/youtube/player_parameters

media

object

Describes the media for displaying on the page.

Only present when media_type is one of:

'instagram'
'tiktok'

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/user-media?query=voluptatem&status=2&type=instagram&favorite=1&group=3&format=csv" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "media_type": "youtube",
            "media_id": "FLR0BB4qDt8",
            "username": "hamida_most",
            "tag_id": null,
            "user_id": null,
            "favorite": 1,
            "show_store": 1,
            "published_at": "2023-05-13",
            "created_at": "2023-07-18T12:02:53.000000Z",
            "updated_at": "2023-07-18T12:09:13.000000Z"
        },
        {
            "id": 2,
            "media_type": "tiktok",
            "username": "juliaringblomm",
            "tag_id": null,
            "user_id": null,
            "favorite": 1,
            "show_store": 0,
            "published_at": "2023-06-17",
            "created_at": "2023-07-18T12:10:49.000000Z",
            "updated_at": "2023-07-18T13:39:28.000000Z",
            "media": {
                "content_type": "video/mp4",
                "href": "https://metapic-tiktok-media.example/juliaringblomm/7245692137566653722"
            }
        },
        {
            "id": 3,
            "media_type": "instagram",
            "username": "juliaringblomm",
            "tag_id": null,
            "user_id": null,
            "favorite": 1,
            "show_store": 0,
            "published_at": "2023-06-17",
            "created_at": "2023-07-18T12:10:49.000000Z",
            "updated_at": "2023-07-18T13:39:28.000000Z",
            "media": {
                "content_type": "video/mp4",
                "href": "https://metapic-instragram-media.example/juliaringblomm/7245692137566653722"
            }
        },
        {
            "id": 4,
            "media_type": "instagram",
            "username": "juliaringblomm",
            "tag_id": null,
            "user_id": null,
            "favorite": 1,
            "show_store": 0,
            "published_at": "2023-06-17",
            "created_at": "2023-07-18T12:10:49.000000Z",
            "updated_at": "2023-07-18T13:39:28.000000Z",
            "media": {
                "content_type": "image/jpeg",
                "href": "https://metapic-instragram-media.example/juliaringblomm/7245692137566653722"
            }
        }
    ],
    "first_page_url": "http://metapic-api.my/user-media?page=1",
    "from": 1,
    "last_page": 3,
    "last_page_url": "http://metapic-api.my/user-media?page=3",
    "links": [
        {
            "url": null,
            "label": "&laquo; Previous",
            "active": false
        },
        {
            "url": "http://metapic-api.my/user-media?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "http://metapic-api.my/user-media?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "http://metapic-api.my/user-media?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "http://metapic-api.my/user-media?page=2",
            "label": "Next &raquo;",
            "active": false
        }
    ],
    "next_page_url": "http://metapic-api.my/user-media?page=2",
    "path": "http://metapic-api.my/user-media",
    "per_page": 5,
    "prev_page_url": null,
    "to": 5,
    "total": 12
}

Endpoints

Get Store Categories

GET

https://api.metapic.dev

/v2/store-categories

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Auth

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/store-categories" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[
    {
        "id": null,
        "name": "Fashion"
    },
    {
        "id": null,
        "name": "Books"
    }
]

GET v2/users/{user_id}/stores-by-categories

GET

https://api.metapic.dev

/v2/users/{user_id}/stores-by-categories

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

user_id

integer

required

The ID of the user.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/users/17/stores-by-categories" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

GET v2/users/{user_id}/stores-by-toplist

GET

https://api.metapic.dev

/v2/users/{user_id}/stores-by-toplist

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

user_id

integer

required

The ID of the user.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/users/4/stores-by-toplist" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Entrypoint

App's entrypoint

GET

https://api.metapic.dev

/v2/entrypoint

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

app

string

required

Must be one of:

advertiser
admin
agency
creator

Example:

advertiser

store_id

integer

This field is required when app is advertiser.

Example:

Response Fields

indicators

object

Auth

Headers

Body

{ "app": "advertiser", "store_id": 6 }

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/entrypoint" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"app\": \"advertiser\",
    \"store_id\": 6
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Offer

Create campaign

POST

https://api.metapic.dev

/v2/stores/{store_id}/offers

requires authentication

Creates new campaign for a store.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The store ID.

Example:

Body Parameters

store_group_id

integer

required

Store group to which the campaign belongs to. Must be one of chosen store's store groups.

Example:

type

string

required

Type of the campaign.

Must be one of:

standard
user_accept
store_accept
suggestion

Example:

store_accept

name

string

required

Admin-only Internal name of the campaign, not visible to the creators and advertisers. Required when campaign_title is empty, otherwise it will default to the same value. Must not be greater than 255 characters.

Example:

Summer campaign for VIP creators

campaign_title

string

required

The title of the campaign, visible to the creators and advertisers. Required if type != "standard". Must not be greater than 255 characters.

Example:

Summer campaign

campaign_text

string

The description of the campaign, visible to the creators and advertisers. Must not be greater than 1056 characters.

Example:

This is a summer campaign!

has_product_seeding

boolean

required

Whether the campaign offers product seeding.

has_onetime_payment

boolean

required

Whether the campaign offers a fixed fee for creators.

Example:

per_user_limit

boolean

required

Whether the click limit is applied per creator or in total.

Example:

one_time_payment

number

The fixed fee amount, if applicable.

Example:

4.5

max_money

number

deprecated Budget limit of the campaign.

Example:

0.88

budget_limit

integer

Specifies the campaign’s budget limit in minor units (e.g., cents). Can function independently of the shared budget.

Example:

max_clicks

integer

The click limit of a campaign.

Example:

valid_from

string

The start datetime of the campaign. Must be a valid date.

Example:

2024-11-20T16:38:42

valid_until

string

The end datetime of the campaign. Must be a valid date. Must be a date after from.

Example:

2123-07-18

todo

string[]

Must not be greater than 255 characters.

Example:

["ruttevexcrez"]

store_visibility

string

Admin-only Toggle visibility of the store for the creators:

STORE_VISIBILITY_NONE = 0 -- do nothing, keep store visibility
STORE_VISIBILITY_HIDE = 1 -- hides store, even if store set to visible
STORE_VISIBILITY_SHOW = 2 -- shows store, even if store set to hidden

Must be one of:

Example:

show_for_advertiser

boolean

Admin-only Toggle campaign visibility in the advertiser-app.

priority_after

integer

Admin-only ID of the campaign with higher priority from the same advertiser, after which to add the new campaign. If null is passed, the new campaign will be added on top of all other campaigns (highest priority). If the property is not present at all, a default priority will be assigned which is below the lowest-priority campaign of type=standard from that advertiser (meant to be used in cases where a priority isn't explicitly chosen, like in advertiser-app).

Example:

traffic_sources_costs

object[]

Array of traffic sources costs applicable to the campaign.

source

integer

required

Source of the cost, e.g. Other (0), Instagram (1), TikTok (2).

Example:

cpc

integer

Cost per click amount, expressed in minor unit (e.g. cents).

Example:

230

cpa

number

Cost per action, expressed in percentage / 100. Must be between 0 and 1.

Example:

0.2

invoice_cpc

integer

Admin-only cpc amount, if advertiser is invoiced directly.

Example:

250

invoice_cpa

number

Admin-only cpa amount, if advertiser is invoiced directly. Must be between 0 and 1.

Example:

0.25

user_revenue

number

Must be between 0 and 1.

Example:

targets

object

Target audience of the campaign. Each target maps to a user which will be added to the campaign.

user_ids

integer[]

Example:

[12]

user_tag_ids

integer[]

Example:

[8]

store_group_ids

integer[]

Example:

[11]

emails

string[]

The value format is invalid.

Example:

["[email protected]"]

social_media_identifiers

string[]

Must not be greater than 30 characters.

Example:

["axvsbuyfyopgjmi"]

client_ids

integer[]

Example:

[20]

revenue_tier_ids

integer[]

Example:

[19]

shared_budget_id

string

Admin-only ID of the existing shared budget to assign to the campaign. If shared_budget_id is null campaign will be unassigned from shared budget.

Example:

shared_budget

object

Admin-only Object representing the shared budget to be created and assigned to the campaign. Prohibits shared_budget_id from being present.

Response Fields

warnings

object[]

Contains any warnings for creating campaign targets

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Body

{ "store_group_id": 2, "type": "store_accept", "name": "Summer campaign for VIP creators", "campaign_title": "Summer campaign", "campaign_text": "This is a summer campaign!", "has_product_seeding": false, "has_onetime_payment": true, "per_user_limit": true, "one_time_payment": 4.5, "max_money": 0.88, "budget_limit": 2, "max_clicks": 16, "valid_from": "2024-11-20T16:38:42", "valid_until": "2123-07-18", "todo": [ "ruttevexcrez" ], "store_visibility": "0", "show_for_advertiser": false, "priority_after": 7, "traffic_sources_costs": [ { "source": 1, "cpc": 230, "cpa": 0.2, "invoice_cpc": 250, "invoice_cpa": 0.25, "user_revenue": 1 } ], "targets": { "user_ids": [ 12 ], "user_tag_ids": [ 8 ], "store_group_ids": [ 11 ], "emails": [ "[email protected]" ], "social_media_identifiers": [ "axvsbuyfyopgjmi" ], "client_ids": [ 20 ], "revenue_tier_ids": [ 19 ] }, "shared_budget_id": 1, "shared_budget": { "title": "Summer budget", "amount": 10000 } }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/stores/15/offers" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"store_group_id\": 2,
    \"type\": \"store_accept\",
    \"name\": \"Summer campaign for VIP creators\",
    \"campaign_title\": \"Summer campaign\",
    \"campaign_text\": \"This is a summer campaign!\",
    \"has_product_seeding\": false,
    \"has_onetime_payment\": true,
    \"per_user_limit\": true,
    \"one_time_payment\": 4.5,
    \"max_money\": 0.88,
    \"budget_limit\": 2,
    \"max_clicks\": 16,
    \"valid_from\": \"2024-11-20T16:38:42\",
    \"valid_until\": \"2123-07-18\",
    \"todo\": [
        \"ruttevexcrez\"
    ],
    \"store_visibility\": \"0\",
    \"show_for_advertiser\": false,
    \"priority_after\": 7,
    \"shared_budget_id\": 1,
    \"shared_budget\": {
        \"title\": \"Summer budget\",
        \"amount\": 10000
    },
    \"targets\": {
        \"user_ids\": [
            12
        ],
        \"user_tag_ids\": [
            8
        ],
        \"store_group_ids\": [
            11
        ],
        \"emails\": [
            \"[email protected]\"
        ],
        \"social_media_identifiers\": [
            \"axvsbuyfyopgjmi\"
        ],
        \"client_ids\": [
            20
        ],
        \"revenue_tier_ids\": [
            19
        ]
    },
    \"traffic_sources_costs\": [
        {
            \"source\": 1,
            \"cpc\": 230,
            \"cpa\": 0.2,
            \"invoice_cpc\": 250,
            \"invoice_cpa\": 0.25,
            \"user_revenue\": 1
        }
    ]
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.metapic.dev/v2/stores/15/offers';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => '{accessToken}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'store_group_id' => 2,
            'type' => 'store_accept',
            'name' => 'Summer campaign for VIP creators',
            'campaign_title' => 'Summer campaign',
            'campaign_text' => 'This is a summer campaign!',
            'has_product_seeding' => false,
            'has_onetime_payment' => true,
            'per_user_limit' => true,
            'one_time_payment' => 4.5,
            'max_money' => 0.88,
            'budget_limit' => 2,
            'max_clicks' => 16,
            'valid_from' => '2024-11-20T16:38:42',
            'valid_until' => '2123-07-18',
            'todo' => [
                'ruttevexcrez',
            ],
            'store_visibility' => '0',
            'show_for_advertiser' => false,
            'priority_after' => 7,
            'shared_budget_id' => 1,
            'shared_budget' => [
                'title' => 'Summer budget',
                'amount' => 10000,
            ],
            'targets' => [
                'user_ids' => [
                    12,
                ],
                'user_tag_ids' => [
                    8,
                ],
                'store_group_ids' => [
                    11,
                ],
                'emails' => [
                    '[email protected]',
                ],
                'social_media_identifiers' => [
                    'axvsbuyfyopgjmi',
                ],
                'client_ids' => [
                    20,
                ],
                'revenue_tier_ids' => [
                    19,
                ],
            ],
            'traffic_sources_costs' => [
                [
                    'source' => 1,
                    'cpc' => 230,
                    'cpa' => 0.2,
                    'invoice_cpc' => 250,
                    'invoice_cpa' => 0.25,
                    'user_revenue' => 1,
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "data": {
        "id": null,
        "campaign_title": "Jovanny Turner",
        "campaign_text": "Dolores et architecto non est alias eum. Sed delectus dolores quibusdam est explicabo tenetur. Ut omnis totam et voluptas odit et.",
        "has_product_seeding": null,
        "has_onetime_payment": null,
        "status": "active",
        "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBlZTY2P3RleHQ9cmVydW0=",
        "image": null,
        "store_id": 1122,
        "token": null,
        "type": "standard",
        "warnings": {
            "skipped_targets": {
                "user_ids": [
                    12,
                    15
                ]
            }
        }
    },
    "warnings": {
        "skipped_targets": {
            "user_ids": [
                12,
                15
            ]
        }
    }
}

Display campaign

GET

https://api.metapic.dev

/v2/offers/{offer_id}

requires authentication

Returns information about a specific campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Response Fields

warnings

Contains any warnings when creating campaign targets

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/15556" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "campaign_title": "Joyce Monahan",
    "campaign_text": "Est laborum quis ipsum nulla delectus numquam voluptas dolorum. Reprehenderit atque nihil inventore et voluptas. Ut qui ipsam libero dolorum harum enim.",
    "has_product_seeding": null,
    "has_onetime_payment": null,
    "status": "active",
    "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBiYjMzP3RleHQ9dXQ=",
    "image": null,
    "store_id": 1123,
    "token": null,
    "type": "standard"
}

Update campaign

PUT

PATCH

https://api.metapic.dev

/v2/offers/{id}

requires authentication

Updates existing campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the offer.

Example:

offer_id

integer

required

The offer ID

Example:

15556

Body Parameters

store_group_id

integer

required

Store group to which the campaign belongs to. Must be one of chosen store's store groups.

Example:

type

string

required

Type of the campaign.

Must be one of:

standard
user_accept
store_accept
suggestion

Example:

suggestion

name

string

required

Example:

Summer campaign for VIP creators

campaign_title

string

required

The title of the campaign, visible to the creators and advertisers. Required if type != "standard". Must not be greater than 255 characters.

Example:

Summer campaign

campaign_text

string

The description of the campaign, visible to the creators and advertisers. Must not be greater than 1056 characters.

Example:

This is a summer campaign!

has_product_seeding

boolean

required

Whether the campaign offers product seeding.

Example:

has_onetime_payment

boolean

required

Whether the campaign offers a fixed fee for creators.

per_user_limit

boolean

required

Whether the click limit is applied per creator or in total.

one_time_payment

number

The fixed fee amount, if applicable.

Example:

max_money

number

deprecated Budget limit of the campaign.

Example:

4168.182484058

budget_limit

integer

Specifies the campaign’s budget limit in minor units (e.g., cents). Can function independently of the shared budget.

Example:

max_clicks

integer

The click limit of a campaign.

Example:

valid_from

string

The start datetime of the campaign. Must be a valid date.

Example:

2024-11-20T16:38:42

valid_until

string

The end datetime of the campaign. Must be a valid date. Must be a date after from.

Example:

1995-06-08

todo

string[]

Must not be greater than 255 characters.

Example:

["xomvzzzspfbrzyudjyoyjhwp"]

store_visibility

string

Admin-only Toggle visibility of the store for the creators:

STORE_VISIBILITY_NONE = 0 -- do nothing, keep store visibility
STORE_VISIBILITY_HIDE = 1 -- hides store, even if store set to visible
STORE_VISIBILITY_SHOW = 2 -- shows store, even if store set to hidden

Must be one of:

Example:

show_for_advertiser

boolean

Admin-only Toggle campaign visibility in the advertiser-app.

priority_after

integer

Example:

traffic_sources_costs

object[]

required

Array of traffic sources costs applicable to the campaign.

source

integer

required

Source of the cost, e.g. Other (0), Instagram (1), TikTok (2).

Example:

cpc

integer

Cost per click amount, expressed in minor unit (e.g. cents).

Example:

230

cpa

number

Cost per action, expressed in percentage / 100. Must be between 0 and 1.

Example:

0.2

invoice_cpc

integer

Admin-only cpc amount, if advertiser is invoiced directly.

Example:

250

invoice_cpa

number

Admin-only cpa amount, if advertiser is invoiced directly. Must be between 0 and 1.

Example:

0.25

user_revenue

number

Must be between 0 and 1.

Example:

targets

object[]

required

Target audience of the campaign. Each target maps to a user which will be added to the campaign.

user_ids

integer[]

Example:

[6]

user_tag_ids

integer[]

Example:

[8]

store_group_ids

integer[]

Example:

[3]

emails

string[]

The value format is invalid.

Example:

["[email protected]"]

social_media_identifiers

string[]

Must not be greater than 30 characters.

Example:

["alabscuiq"]

client_ids

integer[]

Example:

[14]

revenue_tier_ids

integer[]

Example:

[9]

shared_budget_id

string

Admin-only ID of the existing shared budget to assign to the campaign. If shared_budget_id is null campaign will be unassigned from shared budget.

Example:

shared_budget

object

Admin-only Object representing the shared budget to be created and assigned to the campaign. Prohibits shared_budget_id from being present.

Response Fields

warnings

object[]

Contains any warnings for updating campaign targets

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Body

{ "store_group_id": 15, "type": "suggestion", "name": "Summer campaign for VIP creators", "campaign_title": "Summer campaign", "campaign_text": "This is a summer campaign!", "has_product_seeding": true, "has_onetime_payment": false, "per_user_limit": false, "one_time_payment": 0, "max_money": 4168.182484058, "budget_limit": 19, "max_clicks": 10, "valid_from": "2024-11-20T16:38:42", "valid_until": "1995-06-08", "todo": [ "xomvzzzspfbrzyudjyoyjhwp" ], "store_visibility": "2", "show_for_advertiser": false, "priority_after": 18, "traffic_sources_costs": [ { "source": 1, "cpc": 230, "cpa": 0.2, "invoice_cpc": 250, "invoice_cpa": 0.25, "user_revenue": 0 } ], "targets": [ { "user_ids": [ 6 ], "user_tag_ids": [ 8 ], "store_group_ids": [ 3 ], "emails": [ "[email protected]" ], "social_media_identifiers": [ "alabscuiq" ], "client_ids": [ 14 ], "revenue_tier_ids": [ 9 ] } ], "shared_budget_id": 1, "shared_budget": { "title": "Summer budget", "amount": 10000 } }

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/offers/19" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"store_group_id\": 15,
    \"type\": \"suggestion\",
    \"name\": \"Summer campaign for VIP creators\",
    \"campaign_title\": \"Summer campaign\",
    \"campaign_text\": \"This is a summer campaign!\",
    \"has_product_seeding\": true,
    \"has_onetime_payment\": false,
    \"per_user_limit\": false,
    \"one_time_payment\": 0,
    \"max_money\": 4168.182484058,
    \"budget_limit\": 19,
    \"max_clicks\": 10,
    \"valid_from\": \"2024-11-20T16:38:42\",
    \"valid_until\": \"1995-06-08\",
    \"todo\": [
        \"xomvzzzspfbrzyudjyoyjhwp\"
    ],
    \"store_visibility\": \"2\",
    \"show_for_advertiser\": false,
    \"priority_after\": 18,
    \"traffic_sources_costs\": [
        {
            \"source\": 1,
            \"cpc\": 230,
            \"cpa\": 0.2,
            \"invoice_cpc\": 250,
            \"invoice_cpa\": 0.25,
            \"user_revenue\": 0
        }
    ],
    \"targets\": {
        \"0\": [],
        \"user_ids\": [
            6
        ],
        \"user_tag_ids\": [
            8
        ],
        \"store_group_ids\": [
            3
        ],
        \"emails\": [
            \"[email protected]\"
        ],
        \"social_media_identifiers\": [
            \"alabscuiq\"
        ],
        \"client_ids\": [
            14
        ],
        \"revenue_tier_ids\": [
            9
        ]
    },
    \"shared_budget_id\": 1,
    \"shared_budget\": {
        \"title\": \"Summer budget\",
        \"amount\": 10000
    }
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.metapic.dev/v2/offers/19';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => '{accessToken}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'store_group_id' => 15,
            'type' => 'suggestion',
            'name' => 'Summer campaign for VIP creators',
            'campaign_title' => 'Summer campaign',
            'campaign_text' => 'This is a summer campaign!',
            'has_product_seeding' => true,
            'has_onetime_payment' => false,
            'per_user_limit' => false,
            'one_time_payment' => 0.0,
            'max_money' => 4168.182484058,
            'budget_limit' => 19,
            'max_clicks' => 10,
            'valid_from' => '2024-11-20T16:38:42',
            'valid_until' => '1995-06-08',
            'todo' => [
                'xomvzzzspfbrzyudjyoyjhwp',
            ],
            'store_visibility' => '2',
            'show_for_advertiser' => false,
            'priority_after' => 18,
            'traffic_sources_costs' => [
                [
                    'source' => 1,
                    'cpc' => 230,
                    'cpa' => 0.2,
                    'invoice_cpc' => 250,
                    'invoice_cpa' => 0.25,
                    'user_revenue' => 0,
                ],
            ],
            'targets' => [
                [],
                'user_ids' => [
                    6,
                ],
                'user_tag_ids' => [
                    8,
                ],
                'store_group_ids' => [
                    3,
                ],
                'emails' => [
                    '[email protected]',
                ],
                'social_media_identifiers' => [
                    'alabscuiq',
                ],
                'client_ids' => [
                    14,
                ],
                'revenue_tier_ids' => [
                    9,
                ],
            ],
            'shared_budget_id' => 1,
            'shared_budget' => [
                'title' => 'Summer budget',
                'amount' => 10000,
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "data": {
        "id": null,
        "campaign_title": "Sterling Stroman",
        "campaign_text": "Odio tenetur explicabo dolor in nemo. Quo est sint a fugiat laborum consequatur voluptatibus. Voluptate non aspernatur modi iste voluptatem sed.",
        "has_product_seeding": null,
        "has_onetime_payment": null,
        "status": "active",
        "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBkZGNjP3RleHQ9YXV0",
        "image": null,
        "store_id": 1124,
        "token": null,
        "type": "standard",
        "warnings": {
            "skipped_targets": {
                "user_ids": [
                    12,
                    15
                ]
            }
        }
    },
    "warnings": {
        "skipped_targets": {
            "user_ids": [
                12,
                15
            ]
        }
    }
}

Delete campaign

DELETE

https://api.metapic.dev

/v2/offers/{id}

requires authentication

Soft deletes a campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the offer.

Example:

offer_id

integer

required

The offer ID

Example:

15556

Auth

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.metapic.dev/v2/offers/4" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

List campaigns

GET

https://api.metapic.dev

/v2/offers

requires authentication

Endpoint for querying & sorting all campaigns.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

query

string

Query by either of the following: ID, internal name, title. Returns all offers with id equal to query OR name contains query OR campaign_title contains query. Must not be greater than 64 characters.

Example:

black friday

statuses

string[]

Must be one of:

deleted
ended
scheduled
paused
active

Example:

["scheduled"]

store_ids

integer[]

Query by offer's store. Returns all offers which belong to the given store_ids.

Example:

[1]

store_group_ids

integer[]

Query by offer's store group. Returns all offers which belong to the given store_group_ids.

Example:

[1]

created_by

integer

required

Query by offer's author ID. Returns all offers created by the user making the request

Example:

or_id

integer

Query by offer's ID. Performs an 'OR' search, compared to 'AND' search for other filters, so an offer with given ID is always included in the results, if matched.

Example:

1234

target_user_id

integer

Example:

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

sort_by

string

Example:

created_at:desc

custom_sort_by

string

Must be one of:

ends_soon

Example:

ends_soon

include

string[]

Include optional relationships in the response.

Must be one of:

trafficSourcesCosts
store
targets

Example:

["trafficSourcesCosts"]

format

string

Must be one of:

csv
xlsx

Example:

csv

Response Fields

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers?query=black+friday&statuses[]=scheduled&store_ids[]=1&store_group_ids[]=1&created_by=5&or_id=1234&target_user_id=20&size=20&sort_by=created_at%3Adesc&custom_sort_by=ends_soon&include[]=trafficSourcesCosts&format=csv" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "campaign_title": "Mr. Brayan Batz",
            "campaign_text": "Labore similique voluptatem autem nostrum id consequatur. Soluta placeat nemo non nulla fugit. Voluptatibus omnis animi facere.",
            "has_product_seeding": null,
            "has_onetime_payment": null,
            "status": "active",
            "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBiYjExP3RleHQ9ZXZlbmlldA==",
            "image": null,
            "store_id": 1125,
            "token": null,
            "type": "standard"
        },
        {
            "id": null,
            "campaign_title": "Rashawn Powlowski",
            "campaign_text": "Dolorem autem et inventore quisquam nihil id. Expedita fuga velit consequuntur cum est rem. Est est provident eaque consectetur non aliquid.",
            "has_product_seeding": null,
            "has_onetime_payment": null,
            "status": "active",
            "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMmFhP3RleHQ9Y29ycnVwdGk=",
            "image": null,
            "store_id": 1126,
            "token": null,
            "type": "standard"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Upload campaign image

POST

https://api.metapic.dev

/v2/offers/{offer_id}/uploads

requires authentication

Uploads an image to a campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Body Parameters

default

string

required

Max size: 10240 kb. Allowed types: image/*.

Example:

adipisci

Response Fields

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Body

{ "default": "adipisci" }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/offers/15556/uploads" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"default\": \"adipisci\"
}"

Example response:

{
    "id": null,
    "campaign_title": "Miss Priscilla Flatley V",
    "campaign_text": "Omnis cumque voluptatum distinctio magnam doloribus alias. Nemo laudantium cum alias ea in. Qui impedit quibusdam dicta dolore.",
    "has_product_seeding": null,
    "has_onetime_payment": null,
    "status": "active",
    "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAwMDExP3RleHQ9c2l0",
    "image": null,
    "store_id": 1127,
    "token": null,
    "type": "standard"
}

Pause campaign

PUT

https://api.metapic.dev

/v2/offers/{offer_id}/pause

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Response Fields

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/offers/15556/pause" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "campaign_title": "Sallie Wehner DVM",
    "campaign_text": "Laboriosam suscipit ipsum veniam fugit tempore. Quis laborum harum culpa rerum quos. Dolorem consequatur doloremque non magni adipisci voluptatem consequatur. Sed laudantium minus aut placeat.",
    "has_product_seeding": null,
    "has_onetime_payment": null,
    "status": "active",
    "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA4ODY2P3RleHQ9YWNjdXNhbXVz",
    "image": null,
    "store_id": 1128,
    "token": null,
    "type": "standard"
}

Unpause campaign

PUT

https://api.metapic.dev

/v2/offers/{offer_id}/unpause

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Response Fields

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/offers/15556/unpause" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "campaign_title": "Ms. Haylie Thiel DDS",
    "campaign_text": "Earum possimus maiores architecto sunt rerum odit exercitationem. Accusantium non architecto asperiores. Enim fugiat commodi nemo laboriosam sed explicabo expedita molestiae.",
    "has_product_seeding": null,
    "has_onetime_payment": null,
    "status": "active",
    "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBiYmVlP3RleHQ9Y29uc2VxdWF0dXI=",
    "image": null,
    "store_id": 1129,
    "token": null,
    "type": "standard"
}

Display campaign stats

GET

https://api.metapic.dev

/v2/offers/{offer_id}/stats

requires authentication

Returns statistics about a specific campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Query Parameters

start_date

string

required

The start date for the stats period (YYYY-MM-DD)

Example:

2023-01-01

end_date

string

required

The end date for the stats period (YYYY-MM-DD)

Example:

2023-01-31

Body Parameters

start_date

string

required

Must be a valid date. Must be a date before or equal to end_date.

Example:

2010-04-06

end_date

string

required

Must be a valid date. Must be a date after or equal to start_date.

Example:

2064-06-04

Auth

Headers

URL Parameters

Query Parameters

Body

{ "start_date": "2010-04-06", "end_date": "2064-06-04" }

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/15556/stats?start_date=2023-01-01&end_date=2023-01-31" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"start_date\": \"2010-04-06\",
    \"end_date\": \"2064-06-04\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

GET v2/users/{user_id}/offers

GET

https://api.metapic.dev

/v2/users/{user_id}/offers

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

user_id

integer

required

The ID of the user.

Example:

Body Parameters

status

string

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

Example:

product_sent

name

string

Must not be greater than 128 characters.

Example:

tehgorlmexy

Auth

Headers

URL Parameters

Body

{ "status": "product_sent", "name": "tehgorlmexy" }

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/users/18/offers" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"status\": \"product_sent\",
    \"name\": \"tehgorlmexy\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Display campaign

GET

https://api.metapic.dev

/v2/offer-by-token/{offer_token}

requires authentication

Returns information about a specific campaign.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_token

string

required

Example:

corrupti

offer_id

integer

required

The offer ID

Example:

15556

Response Fields

warnings

Contains any warnings when creating campaign targets

status

enum

The status of the campaign. Can be one of: ended, scheduled, paused, active, deleted

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offer-by-token/corrupti" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "campaign_title": "Giuseppe Heidenreich",
    "campaign_text": "Expedita aut est tempora consequuntur quod eligendi sed. Illum aliquam sed aut at hic quis. Itaque quo ducimus nesciunt vel rerum. Eaque corrupti aut eum incidunt enim ea impedit nihil.",
    "has_product_seeding": null,
    "has_onetime_payment": null,
    "status": "active",
    "image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBjYzc3P3RleHQ9YXV0",
    "image": null,
    "store_id": 1148,
    "token": null,
    "type": "standard"
}

Offer Target

Get targets for offer

GET

https://api.metapic.dev

/v2/offers/{offer_id}/targets

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Response Fields

user_ids

string[]

store_group_ids

string[]

user_tag_ids

string[]

client_ids

string[]

revenue_tier_ids

string[]

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/15556/targets" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Add new targets to offer

POST

https://api.metapic.dev

/v2/offers/{offer_id}/targets

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The offer ID

Example:

15556

Body Parameters

user_ids

integer[]

Example:

[9]

user_tag_ids

integer[]

Example:

[13]

store_group_ids

integer[]

Example:

[13]

emails

string[]

The value format is invalid.

Example:

["[email protected]"]

social_media_identifiers

string[]

Must not be greater than 30 characters.

Example:

["kcrav"]

client_ids

integer[]

Example:

[11]

revenue_tier_ids

integer[]

Example:

[15]

Response Fields

user_ids

string[]

store_group_ids

string[]

user_tag_ids

string[]

client_ids

string[]

revenue_tier_ids

string[]

warnings

Contains any warnings when adding targets

Auth

Headers

URL Parameters

Body

{ "user_ids": [ 9 ], "user_tag_ids": [ 13 ], "store_group_ids": [ 13 ], "emails": [ "[email protected]" ], "social_media_identifiers": [ "kcrav" ], "client_ids": [ 11 ], "revenue_tier_ids": [ 15 ] }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/offers/15556/targets" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"user_ids\": [
        9
    ],
    \"user_tag_ids\": [
        13
    ],
    \"store_group_ids\": [
        13
    ],
    \"emails\": [
        \"[email protected]\"
    ],
    \"social_media_identifiers\": [
        \"kcrav\"
    ],
    \"client_ids\": [
        11
    ],
    \"revenue_tier_ids\": [
        15
    ]
}"

Offer Participant

Checks if user has been added to the offer.

GET

https://api.metapic.dev

/v2/offers/{offer_id}/users/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

integer

required

The ID of the user.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/1/users/19" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

List participants in a campaign

GET

https://api.metapic.dev

/v2/offers/{offer_id}/participants

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

Body Parameters

query

string

Must not be greater than 128 characters.

Example:

hnafzcwjqso

status

string

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

Example:

store_denied

participants_v2

boolean

Example:

Response Fields

offer_comments_count

The number of comments on this participation.

integer

The unique id of this participant

offer_id

integer

The id of the offer for this participant

display_name

string

The name of the participant

clicks

integer

The number of clicks left for this participant

status

string

The status of this campaign participant

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

pre_registered_email

string|null

The email by which/if the participant was added to the campaign

pre_registered_identifier

string|null

The social media identifier by which/if the participant was added to the campaign

todo

array|null

List of todo items

user_id

int|null

The id of the user, if Metapic user is linked to the participant

username

string|null

The username of the user, if Metapic user is linked to the participant

avatar

string|null

The image associated with the user through social media identifier

social_media

array|null

List of user's social media, if available

Get participant details

GET

https://api.metapic.dev

/v2/offers/{offer_id}/participants/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

integer

required

The ID of the participant.

Example:

Response Fields

integer

The unique id of this participant

offer_id

integer

The id of the offer for this participant

display_name

string

The name of the participant

clicks

integer

The number of clicks left for this participant

status

string

The status of this campaign participant

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

pre_registered_email

string|null

The email by which/if the participant was added to the campaign

pre_registered_identifier

string|null

The social media identifier by which/if the participant was added to the campaign

todo

array|null

List of todo items

user_id

int|null

The id of the user, if Metapic user is linked to the participant

username

string|null

The username of the user, if Metapic user is linked to the participant

avatar

string|null

The image associated with the user through social media identifier

social_media

array|null

List of user's social media, if available

Retrieve participants statistics for an offer

GET

https://api.metapic.dev

/v2/offers/{offer_id}/participants-stats

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

Body Parameters

query

string

Must not be greater than 64 characters.

Example:

lojasjinpqg

active

boolean

required

start_date

string

required

Must be a valid date. Must be a date before or equal to end_date.

Example:

2011-12-03

end_date

string

required

Must be a valid date. Must be a date after or equal to start_date.

Example:

2037-07-10

sort_by

string

Must match the regex /^(clicks|links_created|estimated_gp|estimated_earning_to_cost_ratio):(asc|desc)$/.

Example:

clicks:asc

Response Fields

integer

The unique id of this participant

user_id

int|null

The id of the user, if Metapic user is linked to the participant

display_name

string

The name of the participant

username

string|null

The username of the user, if Metapic user is linked to the participant

avatar

string|null

The image associated with the user through social media identifier

status

string

The status of this campaign participant

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

links_created

integer

The number of links created for this participant

clicks

integer

The number of clicks left for this participant

estimated_gp

number

The estimated GP for this participant

estimated_earning_to_cost_ratio

number

The estimated earning to cost ratio for this participant

Auth

Headers

URL Parameters

Body

{ "query": "lojasjinpqg", "active": false, "start_date": "2011-12-03", "end_date": "2037-07-10", "sort_by": "clicks:asc" }

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/19/participants-stats" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"query\": \"lojasjinpqg\",
    \"active\": false,
    \"start_date\": \"2011-12-03\",
    \"end_date\": \"2037-07-10\",
    \"sort_by\": \"clicks:asc\"
}"

Example response:

{
    "data": [
        {
            "id": null,
            "user_id": 109911,
            "display_name": "delta80",
            "clicks": 805195320,
            "status": "have_posted",
            "username": "delta80",
            "links_created": null,
            "estimated_gp": null,
            "estimated_earning_to_cost_ratio": null
        },
        {
            "id": null,
            "user_id": 109913,
            "display_name": "hkessler",
            "clicks": 835906834,
            "status": "open",
            "username": "hkessler",
            "links_created": null,
            "estimated_gp": null,
            "estimated_earning_to_cost_ratio": null
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}

Retrieve participants count by active/inactive

GET

https://api.metapic.dev

/v2/offers/{offer_id}/participants-count-by-click-activity

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

Body Parameters

start_date

string

required

Must be a valid date. Must be a date before or equal to end_date.

Example:

2009-08-07

end_date

string

required

Must be a valid date. Must be a date after or equal to start_date.

Example:

2060-09-01

Auth

Headers

URL Parameters

Body

{ "start_date": "2009-08-07", "end_date": "2060-09-01" }

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offers/20/participants-count-by-click-activity" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"start_date\": \"2009-08-07\",
    \"end_date\": \"2060-09-01\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Update participant status

PATCH

https://api.metapic.dev

/v2/offers/{offer_id}/participants/{participant_id}/update-status

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_id

integer

required

The ID of the offer.

Example:

participant_id

integer

required

The ID of the participant.

Example:

Body Parameters

status

string

required

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

Example:

open

Response Fields

integer

The unique id of this participant

offer_id

integer

The id of the offer for this participant

display_name

string

The name of the participant

clicks

integer

The number of clicks left for this participant

status

string

The status of this campaign participant

Must be one of:

open
applied
denied
accepted
store_denied
done
suggestion
second_prio
have_posted
have_received
product_sent

pre_registered_email

string|null

The email by which/if the participant was added to the campaign

pre_registered_identifier

string|null

The social media identifier by which/if the participant was added to the campaign

todo

array|null

List of todo items

user_id

int|null

The id of the user, if Metapic user is linked to the participant

username

string|null

The username of the user, if Metapic user is linked to the participant

avatar

string|null

The image associated with the user through social media identifier

social_media

array|null

List of user's social media, if available

Checks if user has been added to the offer.

GET

https://api.metapic.dev

/v2/offer-by-token/{offer_token}/users/{userId}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_token

string

required

Example:

userId

integer

required

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offer-by-token/et/users/7" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    access-control-allow-origin
                                                            : *
                                                                                                                    set-cookie
                                                            : metapic_session=eyJpdiI6IlNFaWRFcnY5OFFma05TZmhvS2hUK2c9PSIsInZhbHVlIjoiWVA5cGRzaFBYQUlWbjFKd3l2QkEvSS8xL095ZGxJMzg5WXVhVitDNnRnNjgydWZ2L291ZWFJNVZjbFZYVGQ3ancyeG4vWlQyeTZKZlYzK0liMGlvREpFNFZFYTJtTWlWa09oWGhqbGtXVXhTYTdMNmI2WWZuTEdZTEozaHJSQk8iLCJtYWMiOiJlMjdiZjZjYmRkMzBhZjc4Nzc5NmUwZmU0YjA0NzljNDE1NWZjOTdhMDI4ZTY3YjJkN2IxMjQxMDMwYjk0MTQyIiwidGFnIjoiIn0%3D; expires=Wed, 20 Nov 2024 17:38:43 GMT; Max-Age=7200; path=/; httponly

{
    "message": "Unauthenticated."
}

Mark user as having joined the campaign

POST

https://api.metapic.dev

/v2/offer-by-token/{offer_token}/users/{user_id}/join

requires authentication

This can only be performed by the user themselves.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_token

string

required

Example:

quod

user_id

integer

required

The ID of the user.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/offer-by-token/quod/users/11/join" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Comment

Add OfferUser comment

POST

https://api.metapic.dev

/v2/offer-users/{offer_user_id}/comments

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_user_id

string

required

The ID of the offerUser.

Example:

Body Parameters

comment

string

required

Must not be greater than 15000 characters.

Example:

ulmjwrnzwga

Auth

Headers

URL Parameters

Body

{ "comment": "ulmjwrnzwga" }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/offer-users/1/comments" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"comment\": \"ulmjwrnzwga\"
}"

Update OfferUser comment

PUT

PATCH

https://api.metapic.dev

/v2/offer-users/{offer_user_id}/comments/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_user_id

string

required

The ID of the offerUser.

Example:

integer

required

The ID of the comment.

Example:

offer_comment_id

string

required

The ID of the comment.

Example:

Body Parameters

comment

string

required

Must not be greater than 15000 characters.

Example:

pybawromuoemztxjojw

Auth

Headers

URL Parameters

Body

{ "comment": "pybawromuoemztxjojw" }

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/offer-users/1/comments/5" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"comment\": \"pybawromuoemztxjojw\"
}"

Delete OfferUser comment

DELETE

https://api.metapic.dev

/v2/offer-users/{offer_user_id}/comments/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offer_user_id

string

required

The ID of the offerUser.

Example:

integer

required

The ID of the comment.

Example:

offerCommentId

string

required

The ID of the comment.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.metapic.dev/v2/offer-users/1/comments/8" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Activity

Get the list of activities on OfferUser card

GET

https://api.metapic.dev

/v2/offer-users/{offerUser}/activities

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

offerUser

integer

required

Example:

Response Fields

type

The type of the activity. Can be one of the following values:
- COMMENT
- DELETED_COMMENT
- STATUS_CHANGE

actor_id

Unique identifier of the user who initiated the activity.
Absent when the activity was caused by the system.

actor_display_name

string

The name of the actor who initiated the activity.
In case of Creator contains username
In case of Admin or Advertiser contains the full name
Absent when the activity was caused by the system.

comment_id

Unique identifier of the comment.
Present when type is COMMENT

comment_text

Contains the comment text.
Present when type is COMMENT

new_status

string

New offerUser status
Present when type is STATUS_CHANGE

old_status

string

Old offerUser status
Present when type is STATUS_CHANGE

created_at

Indicates time at which the activity happened.

updated_at

string

Time of last editing.
Present if comment was edited

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/offer-users/17/activities" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "message": "Unauthenticated."
}

Return Ads

List Return Ads

GET

https://api.metapic.dev

/v2/return-ads

requires authentication

Paginated list of Return Ads

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

Response Fields

name

string

Internal name

advertiser_group_id

integer

The advertiser group to which the Return Ad belongs

affiliate_link

object

Return Ad affiliate link data.

url - string The original affiliate link url.
advertiser_name - string The name of the advertiser.
advertiser_logo - The logo of the advertiser.

author_id

integer

The id of Return Ad author

display_for_all_advertisers

boolean

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group

advertisers

string[]

List of advertisers the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser.

advertiser_categories

string[]

List of advertiser categories the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser category.

styles

object

An object of style attributes for the Return Ad.

image

object

Image object.

url - string A pre-constructed, working URL to the image via imgproxy using a default configuration.
base64 - string The image key, provided as a base64-encoded image path.

starts_at

date

The start datetime for when the Return Ad becomes active.

ends_at

date

The end datetime for when the Return Ad is deactivated.

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/return-ads?size=20" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "name": "Emilie Smith",
            "advertiser_group_id": 2162,
            "affiliate_link": {
                "url": "https://www.ullrich.com/et-atque-laudantium-non-perferendis",
                "advertiser_name": "Durgan-Kub",
                "advertiser_logo": {
                    "url": "https://media.metapic.com/insecure/rs:fill:500:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA5OTAwP3RleHQ9bGF1ZGFudGl1bQ==",
                    "key": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA5OTAwP3RleHQ9bGF1ZGFudGl1bQ==",
                    "base64": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA5OTAwP3RleHQ9bGF1ZGFudGl1bQ==",
                    "base_url": "https://media.metapic.com"
                }
            },
            "author_id": 109916,
            "display_for_all_advertisers": false,
            "styles": null,
            "image": null,
            "starts_at": "2024-10-20T14:38:43.121124Z",
            "ends_at": "2024-12-20T15:38:43.121190Z"
        },
        {
            "id": null,
            "name": "Layne Labadie",
            "advertiser_group_id": 2165,
            "affiliate_link": {
                "url": "http://muller.com/aliquam-beatae-nisi-dolore-eius-blanditiis-dignissimos-omnis",
                "advertiser_name": "Buckridge, Lebsack and Pfannerstill",
                "advertiser_logo": {
                    "url": "https://media.metapic.com/insecure/rs:fill:500:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBjYzY2P3RleHQ9cXVpYQ==",
                    "key": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBjYzY2P3RleHQ9cXVpYQ==",
                    "base64": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBjYzY2P3RleHQ9cXVpYQ==",
                    "base_url": "https://media.metapic.com"
                }
            },
            "author_id": 109918,
            "display_for_all_advertisers": false,
            "styles": null,
            "image": null,
            "starts_at": "2024-10-20T14:38:43.135661Z",
            "ends_at": "2024-12-20T15:38:43.135739Z"
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Create Return Ad

POST

https://api.metapic.dev

/v2/return-ads

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

name

string

required

The internal name of the Return Ad. Must not be greater than 255 characters.

Example:

hpxkgcurqggaxbpodpgk

advertiser_group_id

integer

required

The advertiser group to which the Return Ad belongs.

Example:

return_link

string

required

The URL to redirect users upon clicking the Return Ad. The link must belong to advertisers within the specified advertiser group. Must be a valid URL. Must not be greater than 2048 characters.

Example:

https://advertiser.com

display_for_all_advertisers

boolean

required

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group. When set to true, all associated advertisers and categories will be removed.

advertiser_ids

integer[]

Specific advertiser IDs to display the Return Ad to. This field is excluded if display_for_all_advertisers is set to true. When set to null, all associated advertisers will be removed.

Example:

[18]

advertiser_category_ids

integer[]

Specific advertiser category IDs to display the Return Ad to. This field is excluded if display_for_all_advertisers is set to true. When set to null, all associated advertiser categories will be removed.

Example:

[15]

styles

object

required

An object of style attributes for the Return Ad.

Example:

{"color":"#ffffff"}

image_key

string

The image key, provided as a base64-encoded image path. Exclude from the request to keep current image.

Example:

dG1wL2ltYWdlLmpwZw==

starts_at

string

The start datetime for when the Return Ad becomes active. Must be a valid date.

Example:

2024-11-20T16:38:43

ends_at

string

The end datetime for when the Return Ad is deactivated. Must be a valid date. Must be a date after starts_at.

Example:

2099-12-10

Response Fields

name

string

Internal name

advertiser_group_id

integer

The advertiser group to which the Return Ad belongs

affiliate_link

object

Return Ad affiliate link data.

url - string The original affiliate link url.
advertiser_name - string The name of the advertiser.
advertiser_logo - The logo of the advertiser.

author_id

integer

The id of Return Ad author

display_for_all_advertisers

boolean

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group

advertisers

string[]

List of advertisers the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser.

advertiser_categories

string[]

List of advertiser categories the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser category.

styles

object

An object of style attributes for the Return Ad.

image

object

Image object.

url - string A pre-constructed, working URL to the image via imgproxy using a default configuration.
base64 - string The image key, provided as a base64-encoded image path.

starts_at

date

The start datetime for when the Return Ad becomes active.

ends_at

date

The end datetime for when the Return Ad is deactivated.

Auth

Headers

Body

{ "name": "hpxkgcurqggaxbpodpgk", "advertiser_group_id": 18, "return_link": "https:\/\/advertiser.com", "display_for_all_advertisers": false, "advertiser_ids": [ 18 ], "advertiser_category_ids": [ 15 ], "styles": { "color": "#ffffff" }, "image_key": "dG1wL2ltYWdlLmpwZw==", "starts_at": "2024-11-20T16:38:43", "ends_at": "2099-12-10" }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/return-ads" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"hpxkgcurqggaxbpodpgk\",
    \"advertiser_group_id\": 18,
    \"return_link\": \"https:\\/\\/advertiser.com\",
    \"display_for_all_advertisers\": false,
    \"advertiser_ids\": [
        18
    ],
    \"advertiser_category_ids\": [
        15
    ],
    \"styles\": {
        \"color\": \"#ffffff\"
    },
    \"image_key\": \"dG1wL2ltYWdlLmpwZw==\",
    \"starts_at\": \"2024-11-20T16:38:43\",
    \"ends_at\": \"2099-12-10\"
}"

Example response:

{
    "id": null,
    "name": "Velda Gleichner",
    "advertiser_group_id": 2168,
    "affiliate_link": {
        "url": "https://www.bogan.com/aspernatur-voluptates-dolores-explicabo",
        "advertiser_name": "Bechtelar, Murazik and Turner",
        "advertiser_logo": {
            "url": "https://media.metapic.com/insecure/rs:fill:500:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMjk5P3RleHQ9aGFydW0=",
            "key": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMjk5P3RleHQ9aGFydW0=",
            "base64": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMjk5P3RleHQ9aGFydW0=",
            "base_url": "https://media.metapic.com"
        }
    },
    "author_id": 109920,
    "display_for_all_advertisers": false,
    "styles": null,
    "image": null,
    "starts_at": "2024-10-20T14:38:43.160699Z",
    "ends_at": "2024-12-20T15:38:43.160754Z"
}

Display Return Ad

GET

https://api.metapic.dev

/v2/return-ads/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the return ad.

Example:

Response Fields

name

string

Internal name

advertiser_group_id

integer

The advertiser group to which the Return Ad belongs

affiliate_link

object

Return Ad affiliate link data.

url - string The original affiliate link url.
advertiser_name - string The name of the advertiser.
advertiser_logo - The logo of the advertiser.

author_id

integer

The id of Return Ad author

display_for_all_advertisers

boolean

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group

advertisers

string[]

List of advertisers the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser.

advertiser_categories

string[]

List of advertiser categories the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser category.

styles

object

An object of style attributes for the Return Ad.

image

object

Image object.

url - string A pre-constructed, working URL to the image via imgproxy using a default configuration.
base64 - string The image key, provided as a base64-encoded image path.

starts_at

date

The start datetime for when the Return Ad becomes active.

ends_at

date

The end datetime for when the Return Ad is deactivated.

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/return-ads/16" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "name": "Newell McDermott II",
    "advertiser_group_id": 2171,
    "affiliate_link": {
        "url": "http://www.feil.com/sed-odit-aut-tenetur-voluptas-exercitationem",
        "advertiser_name": "Reinger PLC",
        "advertiser_logo": {
            "url": "https://media.metapic.com/insecure/rs:fill:500:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA1NWFhP3RleHQ9ZGlzdGluY3Rpbw==",
            "key": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA1NWFhP3RleHQ9ZGlzdGluY3Rpbw==",
            "base64": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA1NWFhP3RleHQ9ZGlzdGluY3Rpbw==",
            "base_url": "https://media.metapic.com"
        }
    },
    "author_id": 109922,
    "display_for_all_advertisers": false,
    "styles": null,
    "image": null,
    "starts_at": "2024-10-20T14:38:43.189701Z",
    "ends_at": "2024-12-20T15:38:43.189753Z"
}

Update Return Ad

PUT

PATCH

https://api.metapic.dev

/v2/return-ads/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the return ad.

Example:

Body Parameters

name

string

required

The internal name of the Return Ad. Must not be greater than 255 characters.

Example:

rseizxlrutibghpvz

advertiser_group_id

integer

required

The advertiser group to which the Return Ad belongs.

Example:

return_link

string

required

The URL to redirect users upon clicking the Return Ad. The link must belong to advertisers within the specified advertiser group. Must be a valid URL. Must not be greater than 2048 characters.

Example:

https://advertiser.com

display_for_all_advertisers

boolean

required

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group. When set to true, all associated advertisers and categories will be removed.

Example:

advertiser_ids

integer[]

Specific advertiser IDs to display the Return Ad to. This field is excluded if display_for_all_advertisers is set to true. When set to null, all associated advertisers will be removed.

Example:

[10]

advertiser_category_ids

integer[]

Example:

[5]

styles

object

required

An object of style attributes for the Return Ad.

Example:

{"color":"#ffffff"}

image_key

string

The image key, provided as a base64-encoded image path. Exclude from the request to keep current image.

Example:

dG1wL2ltYWdlLmpwZw==

starts_at

string

The start datetime for when the Return Ad becomes active. Must be a valid date.

Example:

2024-11-20T16:38:43

ends_at

string

The end datetime for when the Return Ad is deactivated. Must be a valid date. Must be a date after starts_at.

Example:

2057-05-21

Response Fields

name

string

Internal name

advertiser_group_id

integer

The advertiser group to which the Return Ad belongs

affiliate_link

object

Return Ad affiliate link data.

url - string The original affiliate link url.
advertiser_name - string The name of the advertiser.
advertiser_logo - The logo of the advertiser.

author_id

integer

The id of Return Ad author

display_for_all_advertisers

boolean

Indicates whether the Return Ad should be displayed to all advertisers in the selected advertiser group

advertisers

string[]

List of advertisers the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser.

advertiser_categories

string[]

List of advertiser categories the Return Ad is targeted to.

id - int Unique identifier of the advertiser.
name - string The name of the advertiser category.

styles

object

An object of style attributes for the Return Ad.

image

object

Image object.

url - string A pre-constructed, working URL to the image via imgproxy using a default configuration.
base64 - string The image key, provided as a base64-encoded image path.

starts_at

date

The start datetime for when the Return Ad becomes active.

ends_at

date

The end datetime for when the Return Ad is deactivated.

Auth

Headers

URL Parameters

Body

{ "name": "rseizxlrutibghpvz", "advertiser_group_id": 16, "return_link": "https:\/\/advertiser.com", "display_for_all_advertisers": true, "advertiser_ids": [ 10 ], "advertiser_category_ids": [ 5 ], "styles": { "color": "#ffffff" }, "image_key": "dG1wL2ltYWdlLmpwZw==", "starts_at": "2024-11-20T16:38:43", "ends_at": "2057-05-21" }

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/return-ads/3" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"rseizxlrutibghpvz\",
    \"advertiser_group_id\": 16,
    \"return_link\": \"https:\\/\\/advertiser.com\",
    \"display_for_all_advertisers\": true,
    \"advertiser_ids\": [
        10
    ],
    \"advertiser_category_ids\": [
        5
    ],
    \"styles\": {
        \"color\": \"#ffffff\"
    },
    \"image_key\": \"dG1wL2ltYWdlLmpwZw==\",
    \"starts_at\": \"2024-11-20T16:38:43\",
    \"ends_at\": \"2057-05-21\"
}"

Example response:

{
    "id": null,
    "name": "Katherine Harber",
    "advertiser_group_id": 2174,
    "affiliate_link": {
        "url": "http://leuschke.biz/rerum-id-sint-ipsam-consequatur.html",
        "advertiser_name": "Okuneva-Mann",
        "advertiser_logo": {
            "url": "https://media.metapic.com/insecure/rs:fill:500:500/g:sm/q:90/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA4OGRkP3RleHQ9c3VudA==",
            "key": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA4OGRkP3RleHQ9c3VudA==",
            "base64": "dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA4OGRkP3RleHQ9c3VudA==",
            "base_url": "https://media.metapic.com"
        }
    },
    "author_id": 109924,
    "display_for_all_advertisers": false,
    "styles": null,
    "image": null,
    "starts_at": "2024-10-20T14:38:43.243367Z",
    "ends_at": "2024-12-20T15:38:43.243420Z"
}

Delete Return Ad

DELETE

https://api.metapic.dev

/v2/return-ads/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the return ad.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.metapic.dev/v2/return-ads/8" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Preview return ad affiliate link

POST

https://api.metapic.dev

/v2/affiliate-link-preview

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

link

string

required

Must be a valid URL. Must not be greater than 2048 characters.

Example:

advertiser_group_id

integer

required

Example:

Response Fields

deeplink_status

string

Status of the affiliate link.

advertiser_name

string

The name of the advertiser

advertiser_logo

string

The logo of the advertiser

Auth

Headers

Body

{ "link": "r", "advertiser_group_id": 6 }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/affiliate-link-preview" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"link\": \"r\",
    \"advertiser_group_id\": 6
}"

Shared Budget

List Shared Budgets

GET

https://api.metapic.dev

/v2/stores/{store_id}/shared-budgets

requires authentication

List Shared Budgets for Store

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The ID of the store.

Example:

Response Fields

title

string

Shared budget title

amount

integer

Amount of the shared budget, in minor units (e.g., cents).

consumed_budget

integer

The amount of budget that has been consumed or spent from the shared budget, expressed in minor units (e.g., cents).

currency

string

Shared budget currency is the same as advertiser

campaigns_count

integer

Number of campaigns assigned to the budget.

campaigns

App\Http\Resources\SharedBudget\CampaignBudgetProgressResource

List of campaigns associated with this shared budget.

Only present on display budget

id - int Unique identifier of the campaign.
title - string The title of the campaign.
name - string The internal name of the campaign.
consumed_budget - int The current amount of money used by the campaign, expressed in minor units (e.g., cents).
status - string Current status of the campaign (e.g., active, ended).
budget_limit - int Budget limit for the campaign, if applicable.
budget_limit_reached_at - string Timestamp when the budget limit was reached.

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/stores/3/shared-budgets" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[
    {
        "id": null,
        "title": "Dr. Enid Kihn III",
        "amount": 3,
        "consumed_budget": 0,
        "currency": "GBP",
        "campaigns_count": 0
    },
    {
        "id": null,
        "title": "Ruthe Barrows",
        "amount": 9,
        "consumed_budget": 0,
        "currency": "PLN",
        "campaigns_count": 0
    }
]

Display Budget

GET

https://api.metapic.dev

/v2/stores/{store_id}/shared-budgets/{id}

requires authentication

Returns information about a specific budget.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The ID of the store.

Example:

integer

required

The ID of the shared budget.

Example:

Response Fields

title

string

Shared budget title

amount

integer

Amount of the shared budget, in minor units (e.g., cents).

consumed_budget

integer

The amount of budget that has been consumed or spent from the shared budget, expressed in minor units (e.g., cents).

currency

string

Shared budget currency is the same as advertiser

campaigns_count

integer

Number of campaigns assigned to the budget.

campaigns

App\Http\Resources\SharedBudget\CampaignBudgetProgressResource

List of campaigns associated with this shared budget.

Only present on display budget

id - int Unique identifier of the campaign.
title - string The title of the campaign.
name - string The internal name of the campaign.
consumed_budget - int The current amount of money used by the campaign, expressed in minor units (e.g., cents).
status - string Current status of the campaign (e.g., active, ended).
budget_limit - int Budget limit for the campaign, if applicable.
budget_limit_reached_at - string Timestamp when the budget limit was reached.

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/stores/10/shared-budgets/7" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": null,
    "title": "Justen Larkin",
    "amount": 9,
    "consumed_budget": 0,
    "currency": "GBP",
    "campaigns_count": 0
}

Update Shared Budget

PUT

PATCH

https://api.metapic.dev

/v2/stores/{store_id}/shared-budgets/{id}

requires authentication

Updates existing budget.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The ID of the store.

Example:

integer

required

The ID of the shared budget.

Example:

Body Parameters

title

string

Title of the shared budget. Must be at least 3 characters. Must not be greater than 255 characters.

Example:

Summer budget

amount

integer

Amount of the shared budget, in minor units (e.g., cents). When lowering the amount all the campaigns added to this shared budget may be marked as ended as a side-effect. When increasing the amount all campaigns which have ended due to budget_limit_reached_at may be reopened.

Example:

10000

Response Fields

title

string

Shared budget title

amount

integer

Amount of the shared budget, in minor units (e.g., cents).

consumed_budget

integer

The amount of budget that has been consumed or spent from the shared budget, expressed in minor units (e.g., cents).

currency

string

Shared budget currency is the same as advertiser

campaigns_count

integer

Number of campaigns assigned to the budget.

campaigns

App\Http\Resources\SharedBudget\CampaignBudgetProgressResource

List of campaigns associated with this shared budget.

Only present on display budget

id - int Unique identifier of the campaign.
title - string The title of the campaign.
name - string The internal name of the campaign.
consumed_budget - int The current amount of money used by the campaign, expressed in minor units (e.g., cents).
status - string Current status of the campaign (e.g., active, ended).
budget_limit - int Budget limit for the campaign, if applicable.
budget_limit_reached_at - string Timestamp when the budget limit was reached.

Auth

Headers

URL Parameters

Body

{ "title": "Summer budget", "amount": 10000 }

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/stores/10/shared-budgets/19" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"title\": \"Summer budget\",
    \"amount\": 10000
}"

Example response:

{
    "id": null,
    "title": "Dr. Kennedi Rohan DDS",
    "amount": 4,
    "consumed_budget": 0,
    "currency": "EUR",
    "campaigns_count": 0
}

Delete Shared Budget

DELETE

https://api.metapic.dev

/v2/stores/{store_id}/shared-budgets/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The ID of the store.

Example:

integer

required

The ID of the shared budget.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.metapic.dev/v2/stores/2/shared-budgets/14" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Store

List stores

GET

https://api.metapic.dev

/v2/stores

requires authentication

Endpoint for querying & sorting all stores.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

query

string

Query by either of the following: ID, store name. Returns all stores with id equal to query OR name contains query. Must not be greater than 255 characters.

Example:

nike

store_group_id

integer

Query by store's store group. Returns all stores which belong to the given store_group_id.

Example:

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

sort_by

string

Example:

created_at:desc

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/stores?query=nike&store_group_id=15&size=20&sort_by=created_at%3Adesc" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "name": "Heller-Reynolds",
            "key": "Heller-Reynolds",
            "currency": "EUR",
            "deeplinkable": true,
            "product_feed": false,
            "categories": [],
            "logo_url": "https://via.placeholder.com/640x480.png/00ccdd?text=adipisci",
            "logo": {
                "url": "https://via.placeholder.com/640x480.png/00ccdd?text=adipisci"
            }
        },
        {
            "id": null,
            "name": "Hilpert, Hermann and Bode",
            "key": "Hilpert, Hermann and Bode",
            "currency": "PLN",
            "deeplinkable": false,
            "product_feed": false,
            "categories": [],
            "logo_url": "https://via.placeholder.com/640x480.png/00eebb?text=molestiae",
            "logo": {
                "url": "https://via.placeholder.com/640x480.png/00eebb?text=molestiae"
            }
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Create new self-service store

POST

https://api.metapic.dev

/v2/stores

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

name

string

required

Store name.

Example:

My Store

domains

string[]

Store domains. Must match the regex /^(https?:\/\/)?([\dA-Za-z.-]+).([A-Za-z.]{2,6})([\/\w .-])\/?$/.

Example:

[["dev.test-test.com"]]

PUT v2/stores/{store_id}/payment

PUT

https://api.metapic.dev

/v2/stores/{store_id}/payment

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

store_id

integer

required

The ID of the store.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request PUT \
    "https://api.metapic.dev/v2/stores/11/payment" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Tag

GET v2/tags/{id}

GET

https://api.metapic.dev

/v2/tags/{id}

requires authentication

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

integer

required

The ID of the tag.

Example:

Auth

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/tags/6" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 300
                                                                                                                    x-ratelimit-remaining
                                                            : 300
                                                                                                                    access-control-allow-origin
                                                            : *

{
    "status": 403,
    "error": "Forbidden"
}

Uploads

Upload image

POST

https://api.metapic.dev

/v2/image-uploads

requires authentication

Uploads an image to tmp folder.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

image

string

required

Max size: 51200 kb. Allowed types: image/*.

Example:

Response Fields

url

string

A pre-constructed, working URL to the image using a default configuration

base64

string

Image key (base64 encoded image path)

key

string

Image key (base64 encoded image path)

base_url

string

The base URL of imageproxy service. Required if url is missing

Auth

Headers

Body

{ "image": "ab" }

Received response

Example request:

curl --request POST \
    "https://api.metapic.dev/v2/image-uploads" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"image\": \"ab\"
}"

User

List users

GET

https://api.metapic.dev

/v2/users

requires authentication

Endpoint for querying & sorting all users.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

query

string

Query by either of the following: ID, username, email. Returns all users with id equal to query OR username contains query OR email contains query. Must not be greater than 64 characters.

Example:

testcreator123

client_id

integer

Query by user's client. Returns all users which belong to the given client_id.

Example:

store_group_id

integer

Query by user's store group. Returns all users which belong to the given store_group_id.

Example:

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

sort_by

string

Example:

created_at:desc

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/users?query=testcreator123&client_id=2&store_group_id=15&size=20&sort_by=created_at%3Adesc" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "username": "mhegmann",
            "email": "[email protected]",
            "client_id": 1765
        },
        {
            "id": null,
            "username": "aharvey",
            "email": "[email protected]",
            "client_id": 1766
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

User Tag

List user tags

GET

https://api.metapic.dev

/v2/user-tags

requires authentication

Endpoint for querying & sorting all user tags.

Headers

Authorization

Example:

{accessToken}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

name

string

Query by user tag's name. Returns all user tags whose name contains the given name. Must not be greater than 255 characters.

Example:

favourites

store_id

integer

Query by user tag's store. Returns all user tags which belong to the given store_id.

Example:

access_levels

object

Query by user tag's access levels. Returns all user tags which have the given access_levels:

ACCESS_LEVEL_ADMIN = 0
ACCESS_LEVEL_ALL = 1
ACCESS_LEVEL_STORE = 2

Must be one of:

Example:

[0,1]

size

integer

Page size. Defaults to 20. Must not be greater than 100.

Example:

sort_by

string

Example:

created_at:desc

Auth

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.metapic.dev/v2/user-tags?name=favourites&store_id=15&access_levels[]=0&access_levels[]=1&size=20&sort_by=created_at%3Adesc" \
    --header "Authorization: {accessToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": null,
            "name": "Brandon Jakubowski",
            "slug": "id-in-in",
            "access_level": 1,
            "store_id": 1146
        },
        {
            "id": null,
            "name": "Jailyn Nicolas",
            "slug": "quod-adipisci-quo",
            "access_level": 1,
            "store_id": 1147
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "/",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}