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

Read public posts associated with a hashtag, including available text, authors, media and engagement. Continue with the returned token and the same hashtag; limit may change. Previously returned posts are excluded. Responses may contain fewer posts than requested, and tokens can expire.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/facebook/hashtag-posts

// 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

Read public posts associated with a hashtag, including available text, authors, media and engagement. Continue with the returned token and the same hashtag; limit may change. Previously returned posts are excluded. Responses may contain fewer posts than requested, and tokens can expire.

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://ecll-litescrape-v3--site-api-web.modal.run/api/facebook/hashtag-posts' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "tag": "nasa",
  "limit": 20
}'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/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

Read public posts associated with a hashtag, including available text, authors, media and engagement. Continue with the returned token and the same hashtag; limit may change. Previously returned posts are excluded. Responses may contain fewer posts than requested, and tokens can expire.

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.

Native failures return HTTP 503 with {"error":"Service unavailable"} and 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://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Facebook APIs