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 👮
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.
Endpoint for querying & sorting all advertiser groups.
Only return advertiser groups which have return ads enabled.
Page size. Defaults to 20. Must not be greater than 100.
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.
curl --request GET \
--get "https://api.metapic.dev/v2/advertiser-groups?return_ad_enabled=&size=20&sort_by=created_at%3Adesc" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"data": [
{
"id": null,
"name": "Rippin, Klein and Rowe",
"key": "ar_IQ",
"currency": "PLN"
},
{
"id": null,
"name": "Reichert Ltd",
"key": "it_IT",
"currency": "SEK"
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
Endpoint for querying & sorting all clients.
Query by client's name or User revenue tier name. Returns all clients matching the given name
. Must not be greater than 255 characters.
Query by client's store group. Returns all clients which belong to the given store_group_id
.
Page size. Defaults to 20. Must not be greater than 100.
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.
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"
{
"data": [
{
"id": null,
"name": "Dr. Lessie Williamson"
},
{
"id": null,
"name": "Torey Windler"
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
Operations on Media posted by Creators
Filters media by username.
Filter user media by show store value.
all
0
1
2
Filters media by type.
all
instagram
tiktok
youtube
Filter user media by favorite value.
all
1
0
:shrug:.
Format to export.
csv
xlsx
json
curl --request GET \
--get "https://api.metapic.dev/v2/user-media?query=aut&status=0&type=instagram&favorite=1&group=2&format=csv" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"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": "« 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 »",
"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
}
curl --request GET \
--get "https://api.metapic.dev/v2/store-categories" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
[
{
"id": null,
"name": "Food"
},
{
"id": null,
"name": "Books"
}
]
The ID of the user.
curl --request GET \
--get "https://api.metapic.dev/v2/users/18/stores-by-categories" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
The ID of the user.
curl --request GET \
--get "https://api.metapic.dev/v2/users/17/stores-by-toplist" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
curl --request GET \
--get "https://api.metapic.dev/v2/entrypoint" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"app\": \"creator\",
\"store_id\": 18
}"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
Creates new campaign for a store.
The store ID.
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\": 14,
\"type\": \"standard\",
\"name\": \"Summer campaign for VIP creators\",
\"campaign_title\": \"Summer campaign\",
\"campaign_text\": \"This is a summer campaign!\",
\"has_product_seeding\": false,
\"has_onetime_payment\": false,
\"per_user_limit\": false,
\"one_time_payment\": 0.3623,
\"budget_limit\": 20,
\"max_clicks\": 5,
\"valid_from\": \"2025-01-10T11:10:59\",
\"valid_until\": \"2021-04-18\",
\"todo\": [
\"owtvnaxne\"
],
\"store_visibility\": \"0\",
\"show_for_advertiser\": false,
\"priority_after\": 14,
\"shared_budget_id\": 1,
\"shared_budget\": {
\"title\": \"Summer budget\",
\"amount\": 10000
},
\"targets\": {
\"user_ids\": [
7
],
\"user_tag_ids\": [
17
],
\"store_group_ids\": [
17
],
\"emails\": [
\"[email protected]\"
],
\"social_media_identifiers\": [
\"gvcwz\"
],
\"client_ids\": [
8
],
\"revenue_tier_ids\": [
14
]
},
\"traffic_sources_costs\": [
{
\"source\": 1,
\"cpc\": 230,
\"cpa\": 0.2,
\"invoice_cpc\": 250,
\"invoice_cpa\": 0.25,
\"user_revenue\": 1
}
]
}"
{
"data": {
"id": null,
"campaign_title": "Vincenzo McGlynn DVM",
"campaign_text": "Magnam saepe cumque hic dolorem deleniti temporibus cum molestiae. Nobis minima corrupti sit ut. Et qui ea blanditiis enim non ipsum et non.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA5OTc3P3RleHQ9dm9sdXB0YXM=",
"image": null,
"store_id": 1611,
"token": null,
"type": "standard",
"warnings": {
"skipped_targets": {
"user_ids": [
12,
15
]
}
}
},
"warnings": {
"skipped_targets": {
"user_ids": [
12,
15
]
}
}
}
Returns information about a specific campaign.
The offer ID
curl --request GET \
--get "https://api.metapic.dev/v2/offers/15556" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Kristy Rath",
"campaign_text": "Consequuntur iste rerum nihil fuga quaerat corrupti recusandae. Quia nam architecto magnam et maxime ut. Porro dignissimos totam magni quia.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAxMTQ0P3RleHQ9dm9sdXB0YXM=",
"image": null,
"store_id": 1612,
"token": null,
"type": "standard"
}
Updates existing campaign.
The ID of the offer.
The offer ID
curl --request PUT \
"https://api.metapic.dev/v2/offers/4" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"store_group_id\": 9,
\"type\": \"standard\",
\"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\": 171459.8912235,
\"budget_limit\": 3,
\"max_clicks\": 12,
\"valid_from\": \"2025-01-10T11:11:00\",
\"valid_until\": \"1994-08-22\",
\"todo\": [
\"oxbrko\"
],
\"store_visibility\": \"0\",
\"show_for_advertiser\": true,
\"priority_after\": 1,
\"traffic_sources_costs\": [
{
\"source\": 1,
\"cpc\": 230,
\"cpa\": 0.2,
\"invoice_cpc\": 250,
\"invoice_cpa\": 0.25,
\"user_revenue\": 0
}
],
\"targets\": {
\"0\": [],
\"user_ids\": [
17
],
\"user_tag_ids\": [
17
],
\"store_group_ids\": [
2
],
\"emails\": [
\"[email protected]\"
],
\"social_media_identifiers\": [
\"soejylwfyqokcdqxopeqoj\"
],
\"client_ids\": [
13
],
\"revenue_tier_ids\": [
1
]
},
\"shared_budget_id\": 1,
\"shared_budget\": {
\"title\": \"Summer budget\",
\"amount\": 10000
}
}"
{
"data": {
"id": null,
"campaign_title": "Breana Lang",
"campaign_text": "Molestiae cupiditate ipsa fugit officia qui qui porro. Iure ex odio aut molestiae porro. Possimus rerum mollitia sunt impedit. Quia suscipit ut sequi minima quo.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMjU1P3RleHQ9cmVwdWRpYW5kYWU=",
"image": null,
"store_id": 1613,
"token": null,
"type": "standard",
"warnings": {
"skipped_targets": {
"user_ids": [
12,
15
]
}
}
},
"warnings": {
"skipped_targets": {
"user_ids": [
12,
15
]
}
}
}
Soft deletes a campaign.
The ID of the offer.
The offer ID
curl --request DELETE \
"https://api.metapic.dev/v2/offers/7" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
Endpoint for querying & sorting all campaigns.
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.
deleted
ended
scheduled
paused
active
Query by offer's store. Returns all offers which belong to the given store_ids
.
Query by offer's store group. Returns all offers which belong to the given store_group_ids
.
Query by offer's author ID. Returns all offers created by the user making the request
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.
Page size. Defaults to 20. Must not be greater than 100.
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.
ends_soon
Include optional relationships in the response.
trafficSourcesCosts
store
targets
sharedBudget
csv
xlsx
curl --request GET \
--get "https://api.metapic.dev/v2/offers?query=black+friday&statuses[]=ended&store_ids[]=1&store_group_ids[]=1&created_by=10&or_id=1234&target_user_id=15&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"
{
"data": [
{
"id": null,
"campaign_title": "Dr. Mariela Dooley II",
"campaign_text": "Rerum repellat voluptate placeat adipisci rem pariatur. Eaque optio sed minus repellendus. Quo numquam rem delectus unde. Autem est quidem consequatur beatae ea dolorem.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA1NTY2P3RleHQ9b21uaXM=",
"image": null,
"store_id": 1614,
"token": null,
"type": "standard"
},
{
"id": null,
"campaign_title": "Dr. Jessy Conroy III",
"campaign_text": "Sed placeat quibusdam et excepturi. Autem doloremque modi sunt molestiae nesciunt. Ad perspiciatis incidunt quo quia a est quidem.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAxMWJiP3RleHQ9Y3VtcXVl",
"image": null,
"store_id": 1615,
"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": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
Uploads an image to a campaign.
The offer ID
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\": \"et\"
}"
{
"id": null,
"campaign_title": "Claud Hammes",
"campaign_text": "Ipsa et quod est nostrum voluptatum iste ut. Minus delectus aut mollitia quo quidem. Porro tenetur dolore dolores doloribus aliquam.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDA2Njk5P3RleHQ9YXV0",
"image": null,
"store_id": 1616,
"token": null,
"type": "standard"
}
The offer ID
curl --request PUT \
"https://api.metapic.dev/v2/offers/15556/pause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Prof. Melyna Schmeler V",
"campaign_text": "Laudantium quaerat consectetur voluptatum qui provident. Quasi cupiditate et temporibus possimus sit et. Rem alias occaecati quam molestias ducimus nulla quas.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMjIyP3RleHQ9bmVtbw==",
"image": null,
"store_id": 1617,
"token": null,
"type": "standard"
}
The offer ID
curl --request PUT \
"https://api.metapic.dev/v2/offers/15556/unpause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Hudson Nicolas",
"campaign_text": "Quis ipsam et ut sit. Exercitationem aliquam debitis dolorem laborum optio quibusdam. Tempore earum sit iure sapiente sunt minus.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBlZTg4P3RleHQ9bmloaWw=",
"image": null,
"store_id": 1618,
"token": null,
"type": "standard"
}
The offer ID
curl --request POST \
"https://api.metapic.dev/v2/offers/15556/pause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Boyd Bergnaum DDS",
"campaign_text": "Rerum eius sequi ut esse. Id laboriosam quia quo incidunt. Quo ullam sunt quas sed. Aut nostrum itaque voluptatem ut.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBlZWVlP3RleHQ9cmVwcmVoZW5kZXJpdA==",
"image": null,
"store_id": 1619,
"token": null,
"type": "standard"
}
The offer ID
curl --request POST \
"https://api.metapic.dev/v2/offers/15556/unpause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Nigel Rau",
"campaign_text": "Et nisi adipisci mollitia vero. Sed vero voluptas reiciendis et vitae ea. Aut dolorem unde et. Incidunt rem tempora autem reiciendis.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDBlZTIyP3RleHQ9ZXhwZWRpdGE=",
"image": null,
"store_id": 1620,
"token": null,
"type": "standard"
}
Returns statistics about a specific campaign.
The offer ID
The start date for the stats period (YYYY-MM-DD)
The end date for the stats period (YYYY-MM-DD)
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\": \"2017-12-10\",
\"end_date\": \"2093-09-19\"
}"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
The ID of the user.
curl --request GET \
--get "https://api.metapic.dev/v2/users/1/offers" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"status\": \"applied\",
\"name\": \"scsbhncq\"
}"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
Returns information about a specific campaign.
The offer ID
curl --request GET \
--get "https://api.metapic.dev/v2/offer-by-token/totam" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"campaign_title": "Olin Reinger",
"campaign_text": "Quos nemo minima vero facere. Dolores laudantium quia quia qui. Reiciendis qui quos nulla cupiditate dolore.",
"has_product_seeding": null,
"has_onetime_payment": null,
"status": "active",
"image_url": "https://media.metapic.com/insecure/rs:fill:800:500/g:sm/dXBsb2Fkcy9odHRwczovL3ZpYS5wbGFjZWhvbGRlci5jb20vNjQweDQ4MC5wbmcvMDAyMmVlP3RleHQ9ZW9z",
"image": null,
"store_id": 1644,
"token": null,
"type": "standard"
}
The offer ID
curl --request GET \
--get "https://api.metapic.dev/v2/offers/15556/targets" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
The offer ID
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\": [
19
],
\"user_tag_ids\": [
1
],
\"store_group_ids\": [
2
],
\"emails\": [
\"[email protected]\"
],
\"social_media_identifiers\": [
\"khrdlptzcyw\"
],
\"client_ids\": [
2
],
\"revenue_tier_ids\": [
1
]
}"
The ID of the offer.
The ID of the user.
curl --request GET \
--get "https://api.metapic.dev/v2/offers/12/users/2" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
The ID of the offer.
curl --request GET \
--get "https://api.metapic.dev/v2/offers/10/participants" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"query\": \"ydlpnqgfz\",
\"status\": \"done\",
\"participants_v2\": true
}"
{
"data": [
{
"id": null,
"offer_id": 597,
"user_id": null,
"display_name": "[email protected]",
"clicks": 30958,
"status": "have_posted",
"pre_registered_email": "[email protected]",
"todo": null,
"payment_amount": null,
"offer_comments_count": 122
},
{
"id": null,
"offer_id": 598,
"user_id": null,
"display_name": "[email protected]",
"clicks": 62,
"status": "have_posted",
"pre_registered_email": "[email protected]",
"todo": null,
"payment_amount": null,
"offer_comments_count": 12395717
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 10,
"to": 2,
"total": 2
}
}
The ID of the offer.
The ID of the participant.
curl --request GET \
--get "https://api.metapic.dev/v2/offers/18/participants/5" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"offer_id": 599,
"user_id": 2671,
"display_name": "gwalker",
"clicks": 4418454,
"status": "suggestion",
"todo": null,
"payment_amount": null
}
The ID of the offer.
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\": \"g\",
\"active\": false,
\"start_date\": \"2009-11-13\",
\"end_date\": \"2029-04-30\",
\"sort_by\": \"estimated_gp:desc\"
}"
{
"data": [
{
"id": null,
"user_id": null,
"display_name": "[email protected]",
"clicks": 799770851,
"status": "denied",
"username": null,
"links_created": null,
"estimated_gp": null,
"estimated_earning_to_cost_ratio": null
},
{
"id": null,
"user_id": 2673,
"display_name": "brooklyn.kub",
"clicks": 29420826,
"status": "open",
"username": "brooklyn.kub",
"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": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 10,
"to": 2,
"total": 2
}
}
The ID of the offer.
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\": \"2017-11-01\",
\"end_date\": \"2081-07-05\"
}"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
The ID of the offer.
The ID of the participant.
curl --request PATCH \
"https://api.metapic.dev/v2/offers/8/participants/5/update-status" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"status\": \"denied\"
}"
{
"id": null,
"offer_id": 602,
"user_id": null,
"display_name": "raquel.nikolaus",
"clicks": 141277,
"status": "suggestion",
"pre_registered_identifier": "raquel.nikolaus",
"todo": null,
"payment_amount": null
}
curl --request GET \
--get "https://api.metapic.dev/v2/offer-by-token/earum/users/7" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
access-control-allow-origin
: *
set-cookie
: metapic_session=eyJpdiI6InRxRVJURTNOa1EzNUMzR3NMTXNpMVE9PSIsInZhbHVlIjoieDk4RjRZN2JNaDRCNTlhUkVJOGd6azBmV29tcDF2anQvZXFZc1g3SlI4MDBWZlRCNXhwbUNTckdKbjU5ZEo1YkxDbzFZRkl2NlRaOCsrMVZDeCs0bGtlT0YyTlZoczAzSmdNZmV3Q2N4RDdrd1hOMDhHVThoc29tZVp3cEI1Qi8iLCJtYWMiOiIxMDYwODFlZmIyYTU2ZTgzOGE5MDI1NmJiNGQ0MWUzNzdiZjRmYzZhNTM2ODE1ZWY5ZWJkZTA0YjljNTJhNWE3IiwidGFnIjoiIn0%3D; expires=Fri, 10 Jan 2025 12:11:00 GMT; Max-Age=7200; path=/; httponly
{
"message": "Unauthenticated."
}
This can only be performed by the user themselves.
The ID of the user.
curl --request POST \
"https://api.metapic.dev/v2/offer-by-token/et/users/10/join" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
The ID of the offerUser.
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\": \"cykecfxqevrdfmqxuhyvdm\"
}"
The ID of the offerUser.
The ID of the comment.
The ID of the comment.
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\": \"toyxrgn\"
}"
The ID of the offerUser.
The ID of the comment.
The ID of the comment.
curl --request DELETE \
"https://api.metapic.dev/v2/offer-users/1/comments/6" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
curl --request GET \
--get "https://api.metapic.dev/v2/offer-users/5/activities" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
cache-control
: no-cache, private
content-type
: application/json
x-ratelimit-limit
: 300
x-ratelimit-remaining
: 300
access-control-allow-origin
: *
{
"message": "Unauthenticated."
}
Paginated list of Return Ads
Page size. Defaults to 20. Must not be greater than 100.
Query by either of the following: ID or name.
Returns all return ads with id equal to query
OR name contains query
. Must not be greater than 64 characters.
Query by return ad's advertiser group. Returns all return ads which belong to the given advertiser_group_ids
.
Query by return ad's advertiser. Returns all return ads which belong to the given advertiser_ids
.
deleted
ended
scheduled
paused
active
Query by return ad's ID. Performs an 'OR' search, compared to 'AND' search for other filters, so an return ad with given ID is always included in the results, if matched.
Query sorted by (name, created_at, starts_at, ends_at, current_clicks, current_views, order_count, order_value, earnings or click_through_rate). 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.
name:asc
name:desc
created_at:asc
created_at:desc
starts_at:asc
starts_at:desc
ends_at:asc
ends_at:desc
current_clicks:asc
current_clicks:desc
current_views:asc
current_views:desc
order_count:asc
order_count:desc
order_value:asc
order_value:desc
earnings:asc
earnings:desc
click_through_rate:asc
click_through_rate:desc
curl --request GET \
--get "https://api.metapic.dev/v2/return-ads?size=20&query=internal+name&advertiser_group_ids[]=1&advertiser_ids[]=1&statuses[]=deleted&created_by=&or_id=1234&sort_by=current_clicks%3Aasc" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"data": [
{
"id": null,
"name": "Orlo Johns",
"advertiser_group_id": 3368,
"affiliate_link": {
"id": 759,
"url": "http://schinner.info/",
"original_url": "http://dach.org/maxime-possimus-similique-tenetur-a-qui",
"mtpc_url": "https://c.mtpc.se/759",
"user_id": 2676,
"country": "GR",
"provider": "fuchsia",
"advertiser": {
"id": 1632,
"name": "Eichmann PLC"
}
},
"author_id": 2677,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.446288Z",
"ends_at": "2025-02-10T10:11:00.446331Z",
"stats": []
},
{
"id": null,
"name": "Jerel Krajcik",
"advertiser_group_id": 3371,
"affiliate_link": {
"id": 760,
"url": "http://www.dare.biz/",
"original_url": "http://littel.com/commodi-unde-voluptatem-sed-fuga-ut-modi-enim-animi",
"mtpc_url": "https://c.mtpc.se/760",
"user_id": 2678,
"country": "BA",
"provider": "navy",
"advertiser": {
"id": 1633,
"name": "Purdy-Huels"
}
},
"author_id": 2679,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.460970Z",
"ends_at": "2025-02-10T10:11:00.461009Z",
"stats": []
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
curl --request POST \
"https://api.metapic.dev/v2/return-ads" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"blnlxtxlvgoulmkoion\",
\"advertiser_group_id\": 5,
\"return_link\": \"https:\\/\\/advertiser.com\",
\"display_for_all_advertisers\": false,
\"advertiser_ids\": [
7
],
\"advertiser_category_ids\": [
4
],
\"styles\": {
\"color\": \"#ffffff\"
},
\"image_key\": \"dG1wL2ltYWdlLmpwZw==\",
\"starts_at\": \"2025-01-10T11:11:00\",
\"ends_at\": \"2060-03-01\",
\"click_limit\": 19,
\"view_limit\": 4
}"
{
"id": null,
"name": "Stanley Zboncak",
"advertiser_group_id": 3374,
"affiliate_link": {
"id": 761,
"url": "http://okon.com/sit-sint-et-doloremque-eveniet-expedita-quis.html",
"original_url": "http://www.cronin.com/est-aliquam-rerum-quos-itaque-nemo",
"mtpc_url": "https://c.mtpc.se/761",
"user_id": 2680,
"country": "GP",
"provider": "green",
"advertiser": {
"id": 1634,
"name": "Glover Inc"
}
},
"author_id": 2681,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.501130Z",
"ends_at": "2025-02-10T10:11:00.501170Z",
"stats": []
}
The ID of the return ad.
curl --request GET \
--get "https://api.metapic.dev/v2/return-ads/10" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"name": "Wilhelm Murazik",
"advertiser_group_id": 3377,
"affiliate_link": {
"id": 762,
"url": "https://powlowski.com/libero-esse-placeat-et-dolorem-minima-iusto-fugit.html",
"original_url": "http://www.fahey.com/id-molestiae-at-aut-et-cupiditate-in-qui",
"mtpc_url": "https://c.mtpc.se/762",
"user_id": 2682,
"country": "TT",
"provider": "olive",
"advertiser": {
"id": 1635,
"name": "D'Amore-Kub"
}
},
"author_id": 2683,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.533005Z",
"ends_at": "2025-02-10T10:11:00.533047Z",
"stats": []
}
The ID of the return ad.
curl --request PUT \
"https://api.metapic.dev/v2/return-ads/17" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"omyznhkfutvmpxygyilozjhf\",
\"return_link\": \"https:\\/\\/advertiser.com\",
\"display_for_all_advertisers\": false,
\"advertiser_ids\": [
18
],
\"advertiser_category_ids\": [
13
],
\"styles\": {
\"color\": \"#ffffff\"
},
\"image_key\": \"dG1wL2ltYWdlLmpwZw==\",
\"starts_at\": \"2025-01-10T11:11:00\",
\"ends_at\": \"2071-12-08\",
\"click_limit\": 9,
\"view_limit\": 12
}"
{
"id": null,
"name": "Tommie Reilly",
"advertiser_group_id": 3380,
"affiliate_link": {
"id": 763,
"url": "http://www.torphy.com/voluptatem-eius-omnis-eligendi-est-harum-quae-laborum.html",
"original_url": "https://www.kertzmann.info/ut-quis-quia-dignissimos-culpa-ut-ipsum-aut-minus",
"mtpc_url": "https://c.mtpc.se/763",
"user_id": 2684,
"country": "CV",
"provider": "fuchsia",
"advertiser": {
"id": 1636,
"name": "Goldner LLC"
}
},
"author_id": 2685,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.565544Z",
"ends_at": "2025-02-10T10:11:00.565583Z",
"stats": []
}
The ID of the return ad.
curl --request DELETE \
"https://api.metapic.dev/v2/return-ads/19" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
Deactivates Return Ad
The ID of the returnAd.
curl --request POST \
"https://api.metapic.dev/v2/return-ads/9/pause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"name": "Lolita Mayer",
"advertiser_group_id": 3383,
"affiliate_link": {
"id": 764,
"url": "https://www.goldner.org/qui-nam-veritatis-quis-sed-quibusdam-aspernatur-fuga-perferendis",
"original_url": "http://jones.com/rem-commodi-qui-blanditiis-incidunt-exercitationem.html",
"mtpc_url": "https://c.mtpc.se/764",
"user_id": 2686,
"country": "PM",
"provider": "olive",
"advertiser": {
"id": 1637,
"name": "Wyman PLC"
}
},
"author_id": 2687,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.599235Z",
"ends_at": "2025-02-10T10:11:00.599301Z",
"stats": []
}
The ID of the returnAd.
curl --request POST \
"https://api.metapic.dev/v2/return-ads/12/unpause" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"name": "Miss Blanche Veum Jr.",
"advertiser_group_id": 3386,
"affiliate_link": {
"id": 765,
"url": "http://www.kautzer.org/odit-non-atque-qui-qui-dolorem-dolorem.html",
"original_url": "http://www.lowe.com/delectus-ex-nisi-quidem-nihil-ipsa-facilis-possimus.html",
"mtpc_url": "https://c.mtpc.se/765",
"user_id": 2688,
"country": "BE",
"provider": "blue",
"advertiser": {
"id": 1638,
"name": "Kirlin and Sons"
}
},
"author_id": 2689,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.629339Z",
"ends_at": "2025-02-10T10:11:00.629405Z",
"stats": []
}
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\": \"ycebhomeakifs\",
\"advertiser_group_id\": 14
}"
List of Return Ads displayed for Advertiser by ID
The ID of the store.
curl --request GET \
--get "https://api.metapic.dev/v2/advertisers/6/return-ads" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
[
{
"id": null,
"name": "Nola Rogahn",
"advertiser_group_id": 3389,
"affiliate_link": {
"id": 766,
"url": "http://bogan.info/sunt-nemo-sed-maxime-enim-molestias-et-veritatis",
"original_url": "http://www.bergstrom.com/saepe-soluta-dolor-commodi-dolore",
"mtpc_url": "https://c.mtpc.se/766",
"user_id": 2690,
"country": "MC",
"provider": "olive",
"advertiser": {
"id": 1639,
"name": "Herzog Inc"
}
},
"author_id": 2691,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.661630Z",
"ends_at": "2025-02-10T10:11:00.661672Z",
"stats": []
},
{
"id": null,
"name": "Dr. Amie Brekke Jr.",
"advertiser_group_id": 3392,
"affiliate_link": {
"id": 767,
"url": "http://www.metz.info/veniam-repudiandae-repellat-odit-pariatur-incidunt-voluptatem",
"original_url": "https://bernier.biz/deserunt-iusto-eveniet-inventore-laboriosam.html",
"mtpc_url": "https://c.mtpc.se/767",
"user_id": 2692,
"country": "AD",
"provider": "aqua",
"advertiser": {
"id": 1640,
"name": "Zboncak LLC"
}
},
"author_id": 2693,
"display_for_all_advertisers": false,
"status": "active",
"styles": null,
"image": null,
"starts_at": "2024-12-10T10:11:00.676055Z",
"ends_at": "2025-02-10T10:11:00.676132Z",
"stats": []
}
]
List Shared Budgets for Store
The ID of the store.
curl --request GET \
--get "https://api.metapic.dev/v2/stores/14/shared-budgets" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
[
{
"id": null,
"title": "Grady Glover",
"amount": 5,
"consumed_budget": 0,
"currency": "GBP"
},
{
"id": null,
"title": "Fiona Towne",
"amount": 9,
"consumed_budget": 0,
"currency": "GBP"
}
]
Returns information about a specific budget.
The ID of the store.
The ID of the shared budget.
curl --request GET \
--get "https://api.metapic.dev/v2/stores/11/shared-budgets/18" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"id": null,
"title": "Mr. Vinnie Pacocha DVM",
"amount": 5,
"consumed_budget": 0,
"currency": "SEK"
}
Updates existing budget.
The ID of the store.
The ID of the shared budget.
curl --request PUT \
"https://api.metapic.dev/v2/stores/11/shared-budgets/10" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"title\": \"Summer budget\",
\"amount\": 10000
}"
{
"id": null,
"title": "Mr. Terrance Legros DVM",
"amount": 1,
"consumed_budget": 0,
"currency": "PLN"
}
The ID of the store.
The ID of the shared budget.
curl --request DELETE \
"https://api.metapic.dev/v2/stores/7/shared-budgets/1" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
Endpoint for querying & sorting all stores.
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.
Query by store's store group. Returns all stores which belong to the given store_group_id
.
Page size. Defaults to 20. Must not be greater than 100.
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.
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"
{
"data": [
{
"id": null,
"name": "Cassin and Sons"
},
{
"id": null,
"name": "Gusikowski, Stark and Renner"
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
curl --request POST \
"https://api.metapic.dev/v2/stores" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"name\": \"My Store\",
\"domains\": [
[
\"dev.test-test.com\"
]
],
\"categories\": [
6
],
\"logo_url\": \"http:\\/\\/marks.com\\/\",
\"country\": \" Example: SE\",
\"currency\": \"Example: EUR\",
\"language\": \"sv\",
\"billing\": {
\"company_name\": \"exercitationem\",
\"street\": \"sed\",
\"postal_code\": \"et\",
\"city\": \"repellat\",
\"vat_number\": \"quos\"
}
}"
{
"id": null,
"name": "Steuber, Bailey and Skiles"
}
The ID of the store.
curl --request PUT \
"https://api.metapic.dev/v2/stores/8/payment" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
The ID of the affiliate link.
curl --request GET \
--get "https://api.metapic.dev/v2/affiliate-links/debitis" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
{
"url": "http://kuphal.net/et-quis-laudantium-incidunt",
"original_url": "http://www.kunde.biz/et-voluptatibus-porro-rerum-qui-odio-quam.html",
"user_id": 2694,
"country": "CR",
"provider": "lime",
"advertiser": {
"id": 1643,
"name": "Boehm-Kunde"
}
}
Uploads an image to tmp folder.
curl --request POST \
"https://api.metapic.dev/v2/image-uploads" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"image\": \"sint\"
}"
Endpoint for querying & sorting all users.
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.
Query by user's client. Returns all users which belong to the given client_id
.
Query by user's store group. Returns all users which belong to the given store_group_id
.
Page size. Defaults to 20. Must not be greater than 100.
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.
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"
{
"data": [
{
"id": null,
"username": "grussel",
"email": "[email protected]",
"client_id": 2717
},
{
"id": null,
"username": "sincere44",
"email": "[email protected]",
"client_id": 2718
}
],
"links": {
"first": "/?page=1",
"last": "/?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "/?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "/",
"per_page": 20,
"to": 2,
"total": 2
}
}
Query by user's advertiser group. Returns all users which belong to the given advertiser_group_id
.
a mix array of user emails and ids. Must not have more than 1000 items.
curl --request POST \
"https://api.metapic.dev/v2/match-users?advertiser_group_id=15&user_emails_or_ids[]=12345&user_emails_or_ids[]=email%40metapic.com" \
--header "Authorization: {accessToken}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
Endpoint for querying & sorting all user tags.
Query by user tag's name. Returns all user tags whose name contains the given name
. Must not be greater than 255 characters.
Query by user tag's store. Returns all user tags which belong to the given store_id
.
Query by user tag's access levels. Returns all user tags which have the given access_levels
:
0
1
2
Page size. Defaults to 20. Must not be greater than 100.
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.
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"