How it works?

The main way JustLikAPI works is by providing you with an API key that you can use to pull data from desired websites (platforms) through our service. It’s very flexible and can be adapted to suit your specific needs.

Its flexibility is one of the reasons we expanded it to also include custom solutions for our clients.

If you have a need for validating/getting review data that isn’t covered in the guide bellow please head over to our custom solutions page for more info about how we can provide you with a solution that will best suit you.

If you are comfortable with using API services and getting the results in .JSON format please consider some typical use cases:

swagger-logo-A49F73BAF4-seeklogo.com

Pulling Reviews / comments from user's profile

 

Use case 1 – Returns all reviews in user’s profile (no matter if they are shown on first page or not)
– The results of this method are Review Objects, which depend on the platform used, but typically contains

  • Review author username
  • Review body
  • Review date
  • Review replies
  • Review images (image URLs)

Request

{
“propertyUrl”:”https://www.yelp.com/restaurantReview”,
“datefrom”:”2018-05-13″ 
}

Response

{
        “propertyName”: “Grazie Pizza”,
        “location”: “Manhattan, NYC”,
        “reviews”: [
              {
                       “reviewId”: “4524325”,
                       “customer”: {
                               “username”: “”,
                               “location”: null,
                               “level”: null
                        },
                        “title”: ”  “,
                        “rating”: “5”,
                        “text”: “Pizza was very tasty”,
                        “reviewedOn”: “2018-05-13”,
                        “photos”: null,
                        “repliedTo”: true,
                        “externalSource”: null,
                        “replies”: [
                                {
                                      “repliedBy”: “Chef Luigi”,
                                      “text”: “Thank you!”
                                 }
}

Use case 2 – Return all reviews posted after Date X (effectively returning only new reviews)

Request

{
“propertyUrl”:”https://www.weddingwire.com/weddingreview”,
“datefrom”:”2018-03-10″ *
}

Response

{
        “propertyName”: “Weddingplanner”,
        “location”: “London,Uk”,
        “reviews”: [
              {
                       “reviewId”: “1324325”,
                       “customer”: {
                               “username”: “”,
                               “location”: null,
                               “level”: null
                        },
                        “title”: ”  “,
                        “rating”: “5”,
                        “text”: “The quality of service was outstanding”,
                        “reviewedOn”: “2018-03-10”,
                        “photos”: null,
                        “repliedTo”: true,
                        “externalSource”: null,
                        “replies”: [
                                {
                                      “repliedBy”: “Weddingplanner”,
                                      “text”: “Thanks for sharing your experience with us”
                                 }
}

Posting replies to existing reviews

Since reply operation requires authentication – this means that your API call will have to contain username / password of user on whose behalf the reply will be posted
Please also note that this operation would require a Read/Write type of subscription

Use case 3 – Post reply to a review (which was previously fetched – see Use Case 1)

Request

{
“propertyUrl”:”https://www.weddingwire.com/weddingreview”,
“username”:”Weddingreal”,
“password”:”w120odwa”,
“reviewId”:”49416187″,
“businessRole”:”Wedding Manager”,
“text”:”Thank you for your review!”
}

Response

{
“success”:true
}

Use case 4 – Modify a reply which was previously posted

Request

{
“propertyUrl”:”https://www.zillow.com/apartmentReview “,
“reviewId”:”49416187″,
“username”:”realestateinc”,
“password”:”ewrsdf234a”,
“businessRole”:”Real Estate Agent Ana”,
“text”:”Thank you for your review!”
}

Response

{
“success”:true
}

Verification of user's profile on specified platform

Use case 5 – Validate profile username / password on specific platform (can be tested on Platform = TripaAdvisor )

Request

{

“propertyUrl” : “https://www.tripadvisor.com”,
“username” : “justTA”,
“password” : “asdw123f”,
“content” : “/9j/4AAQSkZJBAAD/2wBDAAgGBgcGB”,
“text” : “text”   

}

Response

{
“success”:true
}

Use case 6 – Validation of user’s profile (checks if user’s profile exists on specific platform, and returns profile details). Depending on platform it may or may not require username / password for the profile.

Request

{
“propertyUrl”:”https://www.tripadvisor.com/hotelReview”,
“datefrom”:”2018-03-10″ 
}

Response

{
        “propertyName”: “Tropic Heaven”,
        “location”: “Thailand, Pattaya”,
        “reviews”: [
              {
                       “reviewId”: “13233335”,
                       “customer”: {
                               “username”: “”,
                               “location”: null,
                               “level”: null
                        },
                        “title”: ”  “,
                        “rating”: “5”,
                        “text”: “View from hotel room was great “,
                        “reviewedOn”: “2018-03-10”,
                        “photos”: null,
                        “repliedTo”: true,
                        “externalSource”: null,
                        “replies”: [
                                {
                                      “repliedBy”: “TropicHeavenSupport”,
                                      “text”: “Thanks for sharing your experience with us”
                                 }
}

Posting new reviews

 

Use Case 7 – posting a new review on Zomato

Request

{
“propertyUrl”:”https://www.zomato.com/Restaurant_Review”,
“reviewId”:”49416187″,
“username”:”restaurant302″,
“password”:”3029rest1″,
“businessRole”:”ManoloService”,
“text”:”Great place!”
}

Response

{
“success”:true
}

Technical Q&A

Do I need a proxy network in order to use JustLikeAPI?

No, we take care of that. Actually a proxy network is just one of the methods we have in place for avoiding IP bans.

The content I need to fetch is publicly available (no login required). Can JustLikeAPi still fetch it for me?

Sure thing.

How does your API work?

JustLikeAPI offers a REST API. We do not plan to offer a SOAP interface. Please check our API documentation

What operations does your API offer?

We offer the following operations:

– Validate: use it to validate if your client has profile of given platform, and if the username / password provided are valid

– Get: use it to get content (reviews) from platform

– Post: use it to post comment / reply on the given platform, for the given review

– Please check our full API documentation

How is the content you fetch for me structured?

That depends on the platform (website) we’re interfacing for you (each platform has it’s own content definition). Please check our documentation

If the operation fails, will I be notified?

Sure, you will get an error message with diagnostics in response.

What will happen if a platform (website) you're interfacing for me undergoes a change (for example: they changed the structure or layout of their pages)?

You will start getting errors for most of operations. In that case, please contact our support team (TODO: insert email!) – we’ll make sure to fix it ASAP.

Is JustLikeAPi secure?

Of course. All the operations are carried out over secure protocol (HTTPS)

Do you keep any kind of data related to client profiles in your database?

No. JustLikeAPi is a pass-through service. We take the data from your request, and we submit it to the platfom in question, without storing it locally. Storing it locally would mean potential secutiry risk, and we do not want to be exposed to it.

Commercial Q&A

How do you charge for your services?

There are 2 types of charges

– One-off charges: these apply in case you’d like JustLikeAPI to develop an interface to a new website (platform), we haven’t interfaced yet

– Monthly charges: there is a monthly fee associated with each platform you’re using. Further, each platform comes with several traffic plans (Small, Medium, Large, XL) based on the number of Read / Write requests you will be making.

How can I pay?

You can pay by one of the following 3 methods:

– Credit Card

– PayPal

– Bank transfer

Is there a contract / binding period?

No, you’re welcome to pay as you go. However, we do offer incentives for long-term relationships

If you pay for 6 months of service in advance, you’ll get +1 month of service for free

If you pay for 12 months of service in advance, you’ll get +2.5 months of service for free

If you pay for 24 months of service in advance, you’ll get +6 months of service for free

I have paid for 6 months of service, and I'm in my 3rd month now. Can I upgrade the service (need to add more platforms / higher plans)

Sure. We’ll calculate the difference in platforms / plans and you’ll pay only for that difference.