Enhance your application with Uberall's comprehensive API documentation
https://docs.uberall.com/_mock/apis/swagger/
https://uberall.com/api/
https://docs.uberall.com/_mock/apis/swagger/social-posts/directories
https://uberall.com/api/social-posts/directories
curl -i -X GET \
'https://docs.uberall.com/_mock/apis/swagger/social-posts/directories?businessIds=string&excludedLocationIds=string&labels=string&locationGroupIds=string&locationIds=string' \
-H 'accessToken: YOUR_API_KEY_HERE'Directories retrieved
Social Post Directories Response Model
List of directories that are eligible for a post
List of warnings for directories
No contenthttps://docs.uberall.com/_mock/apis/swagger/social-posts
https://uberall.com/api/social-posts
curl -i -X GET \
'https://docs.uberall.com/_mock/apis/swagger/social-posts?isStoreLocator=true&locationIds=string&max=0&offset=0&socialPostStatuses=string' \
-H 'accessToken: YOUR_API_KEY_HERE'No contentA SocialPost object
The title of the Social Post. For type QUESTION_AND_ANSWER this is going to be the question.
The description of the Social Post. For type QUESTION_AND_ANSWER this is going to be the answer.
A link for the Social Post. This is mandatory for a "Special Offer" and should point to a page concerning the offer.
The type of the Social Post. POST, OFFER, QUESTION_AND_ANSWER, EVENT or ALERT.
The current status of the Social Post (scheduled, active, inactive, deleted, not_published, published, impossible)
The starting date of EVENT and OFFER type Social Posts. It is used to indicate when an EVENT/OFFER will start. For API versions older than 20210804, it is used as publicationDate.
The ending date of the Social Post (type=OFFER). The post will be removed from the listings at that date. It also determines when a special offer should end.
The date on which the Social Post will be published. It is used to schedule posts in the future. Format: YYYY-MM-dd'T'HH:mm:ssXXXXX (Example: 2007-12-03T10:15:30+01:00)
The name of the product for a Product Social Post. A Social Post becomes a Product Social Post if that field is set.
Lower price of a Product Social Post if the product has a price range, or the price for the product.
Upper price of the product for Product Social Post. If the price is just a single price and not a range, set only productPriceMin.
The currency of a Product Social Post. It is a 3-letters symbol (EUR, USD, ...).
The list of location labels as entered when creating/updating the Social Post.
The first comment to be posted after a post creation. Only available for INSTAGRAM
Status of the post per directory
The list of businesses IDs as entered when creating/updating the Social Post.
The list of locations IDs as entered when creating/updating the Social Post.
The list of listing page IDs as entered when creating/updating the Social Post.
The list of business page IDs as entered when creating/updating the Social Post.
List of locationIds that should be excluded from the request. Can be used in combination with businessId when some locations should not be considered.
The list of directories as entered when creating/updating the Social Post.
A couponCode for redeeming a "Special Offer" (SocialPost.type=OFFER). Currently only supported for Google Posts.
Terms and Conditions for redeeming a "Special Offer" (SocialPost.type=OFFER). Currently only supported for Google Posts.
https://docs.uberall.com/_mock/apis/swagger/social-posts
https://uberall.com/api/social-posts
curl -i -X POST \
https://docs.uberall.com/_mock/apis/swagger/social-posts \
-H 'Content-Type: application/json' \
-H 'accessToken: YOUR_API_KEY_HERE' \
-d '{
"title": "string",
"description": "string",
"url": "string",
"type": "POST",
"alertType": "COVID_19",
"id": 0,
"status": "SCHEDULED",
"dateStart": "2019-08-24T14:15:22Z",
"dateEnd": "2019-08-24T14:15:22Z",
"publicationDate": "2024-06-25T11:01:00Z",
"isStoreLocator": true,
"productName": "string",
"timeZone": "Europe/Berlin",
"productPriceMin": 0,
"productPriceMax": 0,
"productCurrency": "EUR",
"labels": "['\''Campaign2018'\'', '\''EastCoast'\'']",
"photos": [
{
"redirectUrl": "string",
"description": "string",
"photo": "string"
}
],
"callToActions": [
{
"url": "string",
"directory": "string",
"type": "string"
}
],
"firstComment": "string",
"mentions": [
{
"id": "string",
"name": "string",
"link": "string",
"avatar": "string"
}
],
"statusPerDirectory": {
"GOOGLE": "SCHEDULED",
"FACEBOOK": "PUBLISHED"
},
"publicationsCount": 0,
"canEdit": true,
"locationName": "string",
"businessName": "string",
"warnings": [
"string"
],
"insights": [
{
"metrics": {
"name": "string",
"value": "string"
}
}
],
"owner": {
"id": 0,
"name": "string",
"isApiAdmin": true
},
"businessIds": [
0
],
"locationIds": [
0
],
"listingPages": [
0
],
"businessPages": [
0
],
"locationGroups": [
0
],
"excludedLocationIds": [
0
],
"directories": [
{
"type": "FOURSQUARE",
"url": "string"
}
],
"couponCode": "string",
"termsAndConditions": "string",
"videos": [
"string"
]
}'Social Posts created.
A Social Post is a message for your customers that will be published on some of your listings. This can be a "News", a "Special Offer" or a "Question and Answer".
The title of the Social Post. For type QUESTION_AND_ANSWER this is going to be the question.
The description of the Social Post. For type QUESTION_AND_ANSWER this is going to be the answer.
A link for the Social Post. This is mandatory for a "Special Offer" and should point to a page concerning the offer.
The type of the Social Post. POST, OFFER, QUESTION_AND_ANSWER, EVENT or ALERT.
A special type for Google ALERT posts. Possible values are COVID_19.
The current status of the Social Post (scheduled, active, inactive, deleted, not_published, published, impossible)
The starting date of EVENT and OFFER type Social Posts. It is used to indicate when an EVENT/OFFER will start. For API versions older than 20210804, it is used as publicationDate.
The ending date of the Social Post (type=OFFER). The post will be removed from the listings at that date. It also determines when a special offer should end.
The date on which the Social Post will be published. It is used to schedule posts in the future. Format: YYYY-MM-dd'T'HH:mm:ssXXXXX (Example: 2007-12-03T10:15:30+01:00)
The name of the product for a Product Social Post. A Social Post becomes a Product Social Post if that field is set.
The timezone in which the Social Post should be created
Lower price of a Product Social Post if the product has a price range, or the price for the product.
Upper price of the product for Product Social Post. If the price is just a single price and not a range, set only productPriceMin.
The currency of a Product Social Post. It is a 3-letters symbol (EUR, USD, ...).
The list of location labels as entered when creating/updating the Social Post.
The first comment to be posted after a post creation. Only available for INSTAGRAM
Status of the post per directory
The list of businesses IDs as entered when creating/updating the Social Post.
The list of locations IDs as entered when creating/updating the Social Post.
The list of listing page IDs as entered when creating/updating the Social Post.
The list of business page IDs as entered when creating/updating the Social Post.
List of locationIds that should be excluded from the request. Can be used in combination with businessId when some locations should not be considered.
The list of directories as entered when creating/updating the Social Post.
A couponCode for redeeming a "Special Offer" (SocialPost.type=OFFER). Currently only supported for Google Posts.
Terms and Conditions for redeeming a "Special Offer" (SocialPost.type=OFFER). Currently only supported for Google Posts.
{ "status": "SUCCESS", "message": "string", "warnings": [ "string" ], "response": { "title": "string", "description": "string", "url": "string", "type": "POST", "alertType": "COVID_19", "id": 0, "status": "SCHEDULED", "dateStart": "2019-08-24T14:15:22Z", "dateEnd": "2019-08-24T14:15:22Z", "publicationDate": "2024-06-25T11:01:00Z", "isStoreLocator": true, "productName": "string", "timeZone": "Europe/Berlin", "productPriceMin": 0, "productPriceMax": 0, "productCurrency": "EUR", "labels": "['Campaign2018', 'EastCoast']", "photos": [ … ], "callToActions": [ … ], "firstComment": "string", "mentions": [ … ], "statusPerDirectory": { … }, "publicationsCount": 0, "canEdit": true, "locationName": "string", "businessName": "string", "warnings": [ … ], "insights": [ … ], "owner": { … }, "businessIds": [ … ], "locationIds": [ … ], "listingPages": [ … ], "businessPages": [ … ], "locationGroups": [ … ], "excludedLocationIds": [ … ], "directories": [ … ], "couponCode": "string", "termsAndConditions": "string", "videos": [ … ] } }
Social Posting
Products - Social Posting