Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Facebook documentation

Facebook Hashtag Posts API Alpha

Get public Facebook posts for a hashtag.

GET / POST https://api.litescrape.com/api/facebook/hashtag-posts

For background execution, use POST /api/facebook/hashtag-posts/async. Learn how to submit and poll async requests →

// from request to code

Integrate Facebook Hashtag Posts

Build your request and copy it into your stack. Or let your coding agent set it up.

APIFacebook Hashtag Posts
More options 2
Request parameters

Get public Facebook posts for a hashtag.

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/facebook/hashtag-posts' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "tag": "nasa",
  "limit": 20
}'

JSON POST request example

POST to https://api.litescrape.com/api/facebook/hashtag-posts with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "tag": "nasa",
  "limit": 20
}

Continue a hashtag feed

Read pagination.continuation_token, then repeat the same tag with that token. You may change limit. Previously returned posts are excluded. Results can change between requests.

Stop when pagination.has_next_page is false. Tokens can expire; an unavailable continuation returns a failure.

Continuation POST body
{
  "tag": "nasa",
  "limit": 20,
  "continuation_token": "<pagination.continuation_token>"
}

// request reference

Facebook Hashtag Posts parameters

Send query parameters with GET /api/facebook/hashtag-posts. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

Get public Facebook posts for a hashtag.

tag
HashtagRequired

Hashtag made of letters, digits or underscores, with an optional leading #.

Type string · GET query or POST JSON

  • Pattern: ^#?[A-Za-z0-9_]{1,100}$
limit
LimitOptional

Maximum posts per response; fewer may be available.

Type integer · GET query or POST JSON · Default 20

  • Minimum: 1
  • Maximum: 20
continuation_token
Continuation tokenOptional

Token from pagination.continuation_token in the preceding response. Keep the same hashtag; limit may change. Tokens can expire.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 32768

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include source_url, coverage, incomplete, posts, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the available results.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Results and optional fields vary with the available data.

200 · application/json
{
  "source_url": "https://www.facebook.com/hashtag/nasa/",
  "coverage": "initial",
  "incomplete": true,
  "posts": [
    {
      "post_id": "122143512645170307",
      "url": "https://www.facebook.com/reel/1567983411297824/",
      "text": "An astronaut kneels alone in the moondust, turning a billion-year-old moon rock over in his gloved hands while Earth hangs in the black sky above. Every stone up there is a page from the universe diary — and he is reading it live, 384,000 km from home. If you could bring back ONE thing from the Moon, what would it be? #MoonLanding #NASA #SpaceExploration #Astronaut #LunarMission",
      "creation_time": 1791410449,
      "authors": [
        {
          "id": "61585109211804",
          "name": "Beyond the Moon",
          "url": "https://www.facebook.com/BeyondtheMoon2"
        }
      ],
      "media": [
        {
          "id": "1567983411297824",
          "type": "Video",
          "image": {
            "uri": "https://scontent-sjc6-1.xx.fbcdn.net/v/t15.5256-10/839098836_1104124862589065_3427655015503422647_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=p565x565&_nc_cat=109&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=Hj5HNvUS2TYQ7kNvwF1VZ9f&_nc_oc=Adq7t1EnKcE0GwdevpZp--T34QnLdJRjlcE1nskZfA65NVf00qGPNyC7y6DKC2pkYvE&_nc_zt=23&_nc_ht=scontent-sjc6-1.xx&_nc_gid=pjDnab9VlHowqgjxPkweKw&_nc_ss=7b289&oh=00_AQPc8lPcUEqpqn4zSy852fW4qvmRj9f6xjI1NpkL4NwARQ&oe=6AD1A5AF"
          },
          "thumbnailImage": {
            "uri": "https://scontent-sjc6-1.xx.fbcdn.net/v/t15.5256-10/839098836_1104124862589065_3427655015503422647_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=109&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=Hj5HNvUS2TYQ7kNvwF1VZ9f&_nc_oc=Adq7t1EnKcE0GwdevpZp--T34QnLdJRjlcE1nskZfA65NVf00qGPNyC7y6DKC2pkYvE&_nc_zt=23&_nc_ht=scontent-sjc6-1.xx&_nc_gid=pjDnab9VlHowqgjxPkweKw&_nc_ss=7b289&oh=00_AQPc8lPcUEqpqn4zSy852fW4qvmRj9f6xjI1NpkL4NwARQ&oe=6AD1A5AF"
          },
          "width": 720,
          "height": 1280,
          "playable_duration_in_ms": 10000
        }
      ],
      "engagement": {
        "reaction_count": 2206,
        "share_count": 41,
        "comment_count": 43
      }
    }
  ],
  "pagination": {
    "has_next_page": true,
    "continuation_token": "h1.eyJ2IjoxLCJ0YWciOiJuYXNhIiwiY3Vyc29yIjoie1wiY3VycmVudF9zZWN0aW9uXCI6MTAsXCJzZXJpYWxpemVkX3NlY3Rpb25fY3Vyc29yXCI6XCJ7XFxcInNlcmlhbGl6ZWRfYnJvd3NlX2N1cnNvclxcXCI6XFxcIkFib09jSThFVFkzT2pXeDRYM0dpUHJEbERyWGVzalVxU0xUZl9qWVNaS0hpNWU3VzFZQl9mSHlfQktxdWp4VG15MHFnQ1IzbGc2XzI2YmpYc1NBUGllTUVTTTQ1YzQ0UlJ1bHpzeTE2Ry15V0hLd3Z2REg2Q3Q5dFdZMElqQ2wwYTVLSk5LZkxBazNKOGpvZVpGRHhPRFctbUFSNHNsYTVDbldfRktEaFRfZ1RtUnY4R1ZTYlVHc3o3UE90ZF82Y0gzdmgzWHVDSlhfQ0VXTEgtU2tVc2NMaVpPeFI2OEJDV2FfMEtsOTdxR0F0Y3JILVU2a1hfQ0FJUjZ0bGZ5ZVA1RU1TUzNBakh2RFNHN19US2tya3dwWkxMOXQ3VzZhQXN0YlBJZFRLS3RuU1VxNjcwUUJWQmduUGhjSURJdjVEQndLOEVJWUhyRWFzQWZtX2R5dnM0eHlqLVNfNjI3bmlUTU96T2UyWTA4VTN1Rjl2Y21EQWR0UDdKdUtGN2NDS0FTVF9zN2l3WllDZmpkMWptYTJJRVBBR3BjRjRuX0VFQzFKNVVxZWNwcHUzVzZZWFQ1Mi10SmxZekZObTRlN1BhWUxwbEgyYUJBYUh3MnFwMndFWnBydkhrUkc0NWxKdjJtMDZ4Y0IxemVLNEx3MGEzSEwwZC1HT0JIYkdwZVNrRk5yNzNuSW80M0JLNm5XazVkdU15cVFlNE1QeGVlT0dzSlM5LWo3OThGZTlFTi1BRm1zRENPZVptZHV1SEdBWHYtNjVXZy0weGplSVo4V1d0SGFIMnhwZGpHQmRyRGZWaEF1N3hBUTBmVl9mMURGR1VYSlNfTEM5X0Z1VzlQdk1qMzBcXFwiLFxcXCJicm93c2VfdW5pdF9pZFxcXCI6XFxcImJyb3dzZV9zZXJwOjViNjQ0N2FiLWJjOWYtNDdhYy1iZmZkLThjNGZlNDMzMTRhZFxcXCIsXFxcInRvcF9uX2ZiaWRzX3Nob3duX2F0X3N0YXJ0X29mX3NlY3Rpb25cXFwiOltdfVwiLFwic2Vzc2lvbl9pZFwiOlwiOTE5Zjc3ZTctOGM2MS00MGEyLWIzYTMtZTc2YzVmZTY2MWFhXCIsXCJjdXJyZW50X3BhZ2VfbnVtXCI6MSxcInNlY3Rpb25fdG9fbnVtX3Jlc3VsdHNfc2hvd25cIjp7XCJ0b3BfcG9zdHNcIjoxfSxcInRvcF9uX2ZiaWRzX3Nob3duXCI6WzEyMjE0MzUxMjY0NTE3MDMwN10sXCJxdWlja19wcm9tb3Rpb25fZmJpZHNfc2hvd25cIjpbXSxcIm9yZGVyZWRfc2VjdGlvbnNcIjpbXCJ0b3BfcG9zdHNcIl0sXCJyZWVsc19zaG93blwiOltdLFwicmVlbHNfZmV0Y2hlZFwiOltdfSIsInNlZW5faWRzIjpbIjEyMjE0MzUxMjY0NTE3MDMwNyJdfQ"
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More Facebook APIs